【文章推荐】C# Record 的 ToString 与继承行为深度解析

[gaufung]

Steven Giesel 最新文章，探讨 C# record 类型中 ToString 方法和继承的交互行为。

[gaufung]

原文链接：https://steven-giesel.com/blogPost/9be39ff1-b7fc-4814-abd4-5ea41a07f8d7

[gaufung]

C# Record 的 ToString 与继承行为深度解析

背景

C# 中的 record 类型自引入以来一直备受关注，它自动生成了 ToString、Equals、GetHashCode 等方法。然而，当 record 涉及继承时，ToString 的行为可能会让开发者感到意外。Steven Giesel 在这篇文章中深入剖析了 record 继承链中 ToString 的生成规则和行为表现。

核心内容

1. record 自动生成的 ToString：record 会自动生成一个 PrintMembers 方法和 ToString 方法，ToString 的输出格式为 TypeName { Property1 = Value1, Property2 = Value2 }。

2. 继承场景下的行为：当派生 record 继承基 record 时，编译器如何处理 PrintMembers 的链式调用，以及 ToString 最终呈现的内容。

3. 覆盖 ToString 的注意事项：如果手动重写基类的 ToString，可能会导致继承链中出现意外行为，文章通过具体示例展示了这些陷阱。

4. sealed ToString 的设计意图：record 生成的 ToString 是 sealed 的，这背后的设计考量和对继承的影响。

代码示例

public record Person(string Name, int Age);
public record Employee(string Name, int Age, string Company) : Person(Name, Age);

var emp = new Employee("Alice", 30, "Contoso");
Console.WriteLine(emp);
// 输出: Employee { Name = Alice, Age = 30, Company = Contoso }

// 如果基类重写了 ToString，继承行为会如何变化？
public record PersonWithCustomToString(string Name) 
{
    public override string ToString() => $"I am {Name}";
}
public record EmployeeCustom(string Name, string Role) : PersonWithCustomToString(Name);
// EmployeeCustom 的 ToString 行为可能让你意外！

意义

这篇文章对使用 record 进行领域建模的 .NET 开发者非常有价值。record 在 DDD（领域驱动设计）中常用于值对象，理解其继承行为中的微妙之处可以帮助避免生产环境中的日志输出异常和序列化问题。文章以清晰的代码示例展示了这些边缘场景，是 C# 进阶开发者的必读内容。