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

C# 10 中的 record struct 是轻量级、不可变、值语义的结构类型,自动实现相等比较、ToString 等,需显式或隐式 readonly,不支持 with 表达式和继承,适用于小数据模型与高性能场景。

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

record struct 基本写法

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

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

这样就自动生成了:

  • 只读字段 NameAge
  • 位置构造函数(可直接传参初始化)
  • 基于值的相等比较(== / !=
  • 重写的 EqualsGetHashCodeToString
  • 解构支持(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);
public override string ToString() => $"({X:F2}, {Y:F2})";

}

注意:所有字段/属性仍需保持只读(initget-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 Value, bool Success);

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