C# ref readonly参数方法 C#如何传递大的struct而无需拷贝

风芳君_1400

风芳君_1400

2026-02-02

643人浏览

原创

能,ref readonly参数可避免struct拷贝,但仅限传入可寻址左值且方法内不修改时;传右值会编译报错,in参数语义等价但更简洁安全。

c# ref readonly参数方法 c#如何传递大的struct而无需拷贝

ref readonly参数能避免struct拷贝吗

能,但仅限于方法体内不修改该参数的前提下。C# 7.2 引入的 ref readonly 允许你以只读引用方式传递 struct,彻底跳过值类型的默认按值复制行为——前提是调用方传入的是可寻址的左值(比如局部变量、数组元素、字段),而非临时对象(如字面量或 new 表达式结果)。

常见误区:以为加了 ref readonly 就“一定不拷贝”。其实如果传入的是不可寻址的右值(例如 SomeMethod(ref readonly new BigStruct())),编译器会报错 CS8337: Cannot use a result of 'new BigStruct()' as a ref or out value because it is not a variable,根本过不了编译。

什么时候必须用ref readonly而不是ref

当你需要高性能访问大型 struct(比如含多个 double 字段的几何类型、固定大小缓冲区等),又**明确禁止方法内部修改其状态**时,ref readonly 是唯一兼顾安全与零拷贝的选择。

ref 虽然也避免拷贝,但开放了写权限,容易破坏封装或引发意外副作用;而 readonly 修饰后,编译器会在方法体内对所有成员访问做只读检查:

  • 不能给字段赋值(param.x = 1; → 编译错误)
  • 不能调用非 readonly 成员方法(哪怕该方法逻辑上不修改状态)
  • 可以安全地读取字段、调用 readonly 方法、访问属性(只要 getter 是 readonly)

示例:

C#
C#

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

下载
struct Matrix4x4
{
    public double M11, M12, M13, M14;
    // ... 16个double,约128字节
    public readonly double Determinant => /* 计算逻辑 */;
}
<p>void ProcessMatrix(ref readonly Matrix4x4 m)
{
Console.WriteLine(m.Determinant); // ✅ OK
// m.M11 = 0;                      // ❌ 编译错误
// m.ToString();                   // ❌ 若ToString()不是readonly方法
}</p>

ref readonly参数的调用限制和陷阱

它对调用端有严格要求,稍不注意就触发编译错误或隐式拷贝:

  • 只能传入变量、字段、数组索引等“可寻址位置”,不能传表达式结果(ProcessMatrix(ref readonly GetMatrix()) ❌)
  • 不能用于 async 方法参数(因为 await 可能导致栈帧移动,引用失效)
  • 不能作为 out 或 ref 参数重载的区分依据(void M(ref T) 和 void M(ref readonly T) 不能共存)
  • 若 struct 含引用类型字段(如 string),ref readonly 只保证 struct 本身地址不变、字段不可改,但不阻止通过引用字段间接修改堆对象

性能提示:对于小于 16 字节的小 struct(如 Point, Guid),按值传递反而可能更快——CPU 寄存器能直接承载,避免取地址和解引用开销。

替代方案对比:Span 和 in 参数

C# 7.2 同时引入了 in 参数关键字,语义上等价于 ref readonly,但更简洁且意图更明确:

  • void M(in Matrix4x4 m) 等价于 void M(ref readonly Matrix4x4 m)
  • in 更推荐用于只读输入场景,编译器对其做了额外优化(如允许传入只读临时变量,某些情况下放宽右值限制)
  • 若需切片或遍历 struct 的原始字节(比如序列化),Span 配合 MemoryMarshal.AsBytes 更底层可控,但需 unsafe 或 System.Runtime.CompilerServices.Unsafe

真正复杂的地方在于:是否值得为避免一次拷贝,增加调用约束、破坏 API 易用性?尤其当 struct 生命周期短、调用频次低时,in 带来的收益可能被可维护性成本抵消。实际压测比理论推导更可靠。

相关文章

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

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

下载

相关标签:

字节 c# 编译错误

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

相关专题

更多
string转int
string转int

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

2023.08.02

7639

3

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

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

2025.08.29

4768

10

C++中int、float和double的区别
C++中int、float和double的区别

本专题整合了c++中int和double的区别,阅读专题下面的文章了解更多详细内容。

2025.10.23

924

4

javascriptvoid(o)怎么解决
javascriptvoid(o)怎么解决

javascriptvoid(o)的解决办法:1、检查语法错误;2、确保正确的执行环境;3、检查其他代码的冲突;4、使用事件委托;5、使用其他绑定方式;6、检查外部资源等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.11.23

636

5

java中void的含义
java中void的含义

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

2025.11.27

391

13

堆和栈的区别
堆和栈的区别

堆和栈的区别:1、内存分配方式不同;2、大小不同;3、数据访问方式不同;4、数据的生命周期。本专题为大家提供堆和栈的区别的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.18

7127

5

堆和栈区别
堆和栈区别

堆(Heap)和栈(Stack)是计算机中两种常见的内存分配机制。它们在内存管理的方式、分配方式以及使用场景上有很大的区别。本文将详细介绍堆和栈的特点、区别以及各自的使用场景。php中文网给大家带来了相关的教程以及文章欢迎大家前来学习阅读。

2023.08.10

2908

6

堆和栈的区别
堆和栈的区别

堆和栈的区别:1、内存分配方式不同;2、大小不同;3、数据访问方式不同;4、数据的生命周期。本专题为大家提供堆和栈的区别的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.18

7127

5

堆和栈区别
堆和栈区别

堆(Heap)和栈(Stack)是计算机中两种常见的内存分配机制。它们在内存管理的方式、分配方式以及使用场景上有很大的区别。本文将详细介绍堆和栈的特点、区别以及各自的使用场景。php中文网给大家带来了相关的教程以及文章欢迎大家前来学习阅读。

2023.08.10

2908

6

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程