讲师中心 微信公众号
AI工具推荐 视频效率加速

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

雨瑶酱_7510

雨瑶酱_7510

发布时间:2026-01-23 11:31:32

|

341人浏览过

|

来源于php中文网

原创

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

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 成员不是语法糖,而是编译器帮你守住结构体不变性的第一道防线。

热门AI工具

更多
豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

相关专题

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

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

5824

2023.10.24

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

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

2464

2024.02.23

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

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

1632

2025.10.17

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

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

4094

2025.06.09

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

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

4251

2025.07.04

string转int
string转int

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

5399

2023.08.02

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

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

2725

2024.08.29

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

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

3368

2025.08.29

PixTV AI视频生成与无限画布创作
PixTV AI视频生成与无限画布创作

PixTV专题整理AI视频与视觉内容创作相关功能使用教程,涵盖AI生图、视频生成、无限画布、多模型创作、素材管理、声音音乐及视频剪辑等功能,帮助用户快速掌握PixTV从创意到成片的完整制作方法。

0

2026.09.29

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Conan 2 Essentials 免费课程
Conan 2 Essentials 免费课程

共0课时 | 0人学习

CMake 与 Conan 集成实践
CMake 与 Conan 集成实践

共0课时 | 0人学习

Conan 2 高级依赖模型介绍
Conan 2 高级依赖模型介绍

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn