C#怎么使用Record Types C# 10 Record Struct用法

来源:这里教程网 时间:2026-02-21 17:34:25 作者:

在 C# 10 中,record struct 是一种轻量级、不可变(默认)、值语义的结构类型,适合用于数据载体(如 DTO、返回值、配置项等),相比 class-based record 更省内存、避免堆分配,也比普通 struct 更易用(自动实现

Equals
GetHashCode
ToString
==
/
!=
)。

record struct 基本写法

语法和

record class
类似,但用
struct
关键字替代
class
,且必须是
readonly
(隐式或显式):

public readonly record struct Person(string Name, int Age);

这样就自动生成了:

只读字段
Name
Age
位置构造函数(可直接传参初始化) 基于值的相等比较(
==
/
!=
重写的
Equals
GetHashCode
ToString
解构支持(
var (name, age) = person;

带命名字段和自定义成员的 record struct

你也可以显式声明字段、属性,甚至添加方法或自定义

ToString

public readonly record struct Point(double X, double Y)
{
    public double DistanceFromOrigin => Math.Sqrt(X * X + Y * Y);
<pre class="brush:php;toolbar:false;">public override string ToString() => $"({X:F2}, {Y:F2})";

}

注意:所有字段/属性仍需保持只读(

init
get
-only),否则编译报错。不支持
with
表达式(这是
record class
的特性,
record struct
没有引用语义,也不需要“复制并修改”)。

和普通 struct、record class 的关键区别

vs 普通 struct:不用手动实现
Equals
/
GetHashCode
,不用写构造函数和
ToString
,语义更清晰
vs record class:值类型(栈分配)、不可继承、无
with
、无
Deconstruct
自动生成(除非显式写)、不能为
null
(除非是可空类型如
Person?
适用场景:小数据模型(如坐标、颜色、HTTP 状态码包装、API 响应体片段)、函数式风格参数传递、高性能路径中的临时值对象

使用注意事项

必须加
readonly
(C# 10 要求;省略会编译失败)
不能包含字段初始化器(如
int Count = 0;
),但可以用
init
属性或构造函数赋值
不支持继承(不能
: BaseRecord
),也不能被继承
泛型支持良好:
public readonly record struct Result<t>(T Value, bool Success);</t>

基本上就这些。record struct 不复杂但容易忽略它的值语义和 readonly 强制性——把它当成“带自动契约的轻量数据包”来用最自然。

相关推荐