C# 只读成员(readonly members) - 在结构体中保证不变性

雨瑶酱_7510

雨瑶酱_7510

2026-01-23

341人浏览

原创

readonly成员是C# 7.2引入的结构体不变性保障机制,强制约束readonly实例上调用的方法不修改状态,需显式标注于方法、属性getter等成员,并配合in参数和readonly字段使用。

c# 只读成员(readonly members) - 在结构体中保证不变性

在 C# 中,readonly 成员(C# 7.2 引入)是结构体(struct)实现真正不变性的关键机制。它让编译器强制保证:只要一个结构体实例被标记为 readonly(比如作为只读字段、in 参数或 readonly 局部变量),那么调用其 readonly 成员时,不会意外修改其状态。

为什么结构体需要 readonly 成员?

结构体是值类型,按值传递。但若结构体包含可变字段,又没加约束,很容易在看似“只读”的上下文中被意外修改——比如调用一个非 readonly 的方法,该方法内部却修改了字段。编译器无法阻止这种行为,除非你显式声明成员为 readonly。

没有 readonly 成员时:

  • 即使结构体变量被声明为 readonly,仍可调用非 readonly 方法;
  • 这些方法可能悄悄改写字段,破坏语义上的“只读”承诺;
  • 尤其在 in 参数场景下,容易引发难以调试的副作用。

如何正确声明 readonly 成员?

在方法、属性访问器、索引器、运算符等成员上添加 readonly 修饰符:

C#
C#

"避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

下载
  • 方法:在返回类型前加 readonly,如 public readonly int GetValue() => _value;
  • 属性 getter:在 get 前加 readonly,如 public readonly int Value => _value;
  • 整个属性设为 readonly:表示 get/set 都不能修改状态(set 必须也是 readonly,且通常只用于初始化逻辑);
  • readonly 成员内不可调用非 readonly 成员,也不可直接赋值给任何字段(包括 this 字段)。

readonly 成员与 readonly struct 的区别

readonly struct(C# 7.2+)是更严格的契约:它要求结构体所有实例字段必须是 readonly,且所有成员默认隐式为 readonly(除非显式去掉)。而普通结构体中使用 readonly 成员,是“按需加锁”,更灵活:

  • 允许结构体保留可变字段(如用于内部缓存),但把公共 API 设为 readonly;
  • 适合渐进式改造旧结构体,无需一次性冻结所有字段;
  • 编译器对 readonly struct 有额外优化(如允许安全地按 in 传递)。

实际使用建议

要真正发挥 readonly 成员的作用,需配合使用场景:

  • 把结构体字段尽量设为 readonly,从源头减少可变性;
  • 所有公开的、不改变状态的方法/属性,一律标注 readonly;
  • 在参数中优先用 in 替代 ref 或值传递,此时编译器会强制只调用 readonly 成员;
  • 避免在 readonly 成员里调用非 readonly 方法(编译器报错),也别用 Unsafe.AsRef 等绕过检查——那等于放弃保障。

基本上就这些。readonly 成员不是语法糖,而是编译器帮你守住结构体不变性的第一道防线。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

c#

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

2023.10.24

6424

49

Go语言中的运算符有哪些
Go语言中的运算符有哪些

Go语言中的运算符有:1、加法运算符;2、减法运算符;3、乘法运算符;4、除法运算符;5、取余运算符;6、比较运算符;7、位运算符;8、按位与运算符;9、按位或运算符;10、按位异或运算符等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

3584

5

php三元运算符用法
php三元运算符用法

本专题整合了php三元运算符相关教程,阅读专题下面的文章了解更多详细内容。

2025.10.17

1952

13

golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

2025.06.09

5534

18

golang结构体方法
golang结构体方法

本专题整合了golang结构体相关内容,请阅读专题下面的文章了解更多。

2025.07.04

5711

25

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.02

7639

3

int占多少字节
int占多少字节

int占4个字节,意味着一个int变量可以存储范围在-2,147,483,648到2,147,483,647之间的整数值,在某些情况下也可能是2个字节或8个字节,int是一种常用的数据类型,用于表示整数,需要根据具体情况选择合适的数据类型,以确保程序的正确性和性能。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.08.29

3625

6

c++怎么把double转成int
c++怎么把double转成int

本专题整合了 c++ double相关教程,阅读专题下面的文章了解更多详细内容。

2025.08.29

4788

10

C++中int的含义
C++中int的含义

本专题整合了C++中int相关内容,阅读专题下面的文章了解更多详细内容。

2025.08.29

3185

10

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C++ Core Guidelines
C++ Core Guidelines

共0课时 | 0人学习

C++ Reference
C++ Reference

共0课时 | 0人学习

C++ 官方标准说明
C++ 官方标准说明

共0课时 | 0人学习