public record Person(string FirstName, string LastName)
public string[] PhoneNumbers { get; init; }
public static void Main()
Person person1 = new("Nancy", "Davolio") { PhoneNumbers = new string[1] };
Console.WriteLine(person1);
// output: Person { FirstName = Nancy, LastName = Davolio, PhoneNumbers = System.String[] }
Person person2 = person1 with { FirstName = "John" };
Console.WriteLine(person2);
// output: Person { FirstName = John, LastName = Davolio, PhoneNumbers = System.String[] }
Console.WriteLine(person1 == person2); // output: False
person2 = person1 with { PhoneNumbers = new string[1] };
Console.WriteLine(person2);
// output: Person { FirstName = Nancy, LastName = Davolio, PhoneNumbers = System.String[] }
Console.WriteLine(person1 == person2); // output: False
person2 = person1 with { };
Console.WriteLine(person1 == person2); // output: True
有关详细信息,请参阅有关记录的 C# 语言参考文章中的
非破坏性变化
。
记录类型具有编译器生成的
ToString
方法,可显示公共属性和字段的名称和值。
ToString
方法返回一个格式如下的字符串:
<record type name> { <property name> = <value>, <property name> = <value>, ...}
对于引用类型,将显示属性所引用的对象的类型名称,而不是属性值。 在下面的示例中,数组是一个引用类型,因此显示的是
System.String[]
,而不是实际的数组元素值:
Person { FirstName = Nancy, LastName = Davolio, ChildNames = System.String[] }
有关详细信息,请参阅有关记录的 C# 语言参考文章中的内置格式。
一条记录可以从另一条记录继承。 但是,记录不能从类继承,类也不能从记录继承。
下面的示例说明了具有位置属性语法的继承:
public abstract record Person(string FirstName, string LastName);
public record Teacher(string FirstName, string LastName, int Grade)
: Person(FirstName, LastName);
public static void Main()
Person teacher = new Teacher("Nancy", "Davolio", 3);
Console.WriteLine(teacher);
// output: Teacher { FirstName = Nancy, LastName = Davolio, Grade = 3 }
要使两个记录变量相等,运行时类型必须相等。 包含变量的类型可能不同。 下面的代码示例中说明了这一点:
public abstract record Person(string FirstName, string LastName);
public record Teacher(string FirstName, string LastName, int Grade)
: Person(FirstName, LastName);
public record Student(string FirstName, string LastName, int Grade)
: Person(FirstName, LastName);
public static void Main()
Person teacher = new Teacher("Nancy", "Davolio", 3);
Person student = new Student("Nancy", "Davolio", 3);
Console.WriteLine(teacher == student); // output: False
Student student2 = new Student("Nancy", "Davolio", 3);
Console.WriteLine(student2 == student); // output: True
在本示例中,所有实例都具有相同的属性和相同的属性值。 尽管两者都是 Person
类型变量,但 student == teacher
会返回 False
。 尽管一个是 Person
变量,另一个是 Student
变量,但 student == student2
会返回 True
。
派生类型和基类型的所有公共属性和字段都包含在 ToString
输出中,如以下示例所示:
public abstract record Person(string FirstName, string LastName);
public record Teacher(string FirstName, string LastName, int Grade)
: Person(FirstName, LastName);
public record Student(string FirstName, string LastName, int Grade)
: Person(FirstName, LastName);
public static void Main()
Person teacher = new Teacher("Nancy", "Davolio", 3);
Console.WriteLine(teacher);
// output: Teacher { FirstName = Nancy, LastName = Davolio, Grade = 3 }
有关详细信息,请参阅有关记录的 C# 语言参考文章中的继承。
仅限 Init 的资源库
仅限 init 的资源库提供一致的语法来初始化对象的成员。 属性初始值设定项可明确哪个值正在设置哪个属性。 缺点是这些属性必须是可设置的。 从 C# 9.0 开始,可为属性和索引器创建 init
访问器,而不是 set
访问器。 调用方可使用属性初始化表达式语法在创建表达式中设置这些值,但构造完成后,这些属性将变为只读。 仅限 init 的资源库提供了一个窗口用来更改状态。 构造阶段结束时,该窗口关闭。 在完成所有初始化(包括属性初始化表达式和 with 表达式)之后,构造阶段实际上就结束了。
可在编写的任何类型中声明仅限 init
的资源库。 例如,以下结构定义了天气观察结构:
public struct WeatherObservation
public DateTime RecordedAt { get; init; }
public decimal TemperatureInCelsius { get; init; }
public decimal PressureInMillibars { get; init; }
public override string ToString() =>
$"At {RecordedAt:h:mm tt} on {RecordedAt:M/d/yyyy}: " +
$"Temp = {TemperatureInCelsius}, with {PressureInMillibars} pressure";
调用方可使用属性初始化表达式语法来设置值,同时仍保留不变性:
var now = new WeatherObservation
RecordedAt = DateTime.Now,
TemperatureInCelsius = 20,
PressureInMillibars = 998.0m
初始化后尝试更改观察值会导致编译器错误:
// Error! CS8852.
now.TemperatureInCelsius = 18;
对于从派生类设置基类属性,仅限 init 的资源库很有用。 它们还可通过基类中的帮助程序来设置派生属性。 位置记录使用仅限 init 的资源库声明属性。 这些设置器可在 with 表达式中使用。 可为定义的任何 class
、struct
或 record
声明仅限 init 的资源库。
有关详细信息,请查看 init(C# 参考)。
顶级语句从许多应用程序中删除了不必要的流程。 请考虑规范的“Hello World!”程序:
using System;
namespace HelloWorld
class Program
static void Main(string[] args)
Console.WriteLine("Hello World!");
只有一行代码执行所有操作。 借助顶级语句,可使用 using
指令和执行操作的一行替换所有样本:
using System;
Console.WriteLine("Hello World!");
如果需要单行程序,可删除 using
指令,并使用完全限定的类型名称:
System.Console.WriteLine("Hello World!");
应用程序中只有一个文件可使用顶级语句。 如果编译器在多个源文件中找到顶级语句,则是错误的。 如果将顶级语句与声明的程序入口点方法(通常为 Main
方法)结合使用,也会出现错误。 从某种意义上讲,可认为一个文件包含通常位于 Program
类的 Main
方法中的语句。
此功能最常见的用途之一是创建材料。 C# 初级开发人员可以用一两行代码编写规范的“Hello World!”。 不需要额外的工作。 不过,经验丰富的开发人员还会发现此功能的许多用途。 顶级语句可提供类似脚本的试验体验,这与 Jupyter 笔记本提供的很类似。 顶级语句非常适合小型控制台程序和实用程序。 Azure Functions 是顶级语句的理想用例。
最重要的是,顶层语句不会限制应用程序的范围或复杂程度。 这些语句可访问或使用任何 .NET 类。 它们也不会限制你对命令行参数或返回值的使用。 顶级语句可访问名为 args
的字符串数组。 如果顶级语句返回整数值,则该值将成为来自合成 Main
方法的整数返回代码。 顶级语句可能包含异步表达式。 在这种情况下,合成入口点将返回 Task
或 Task<int>
。
有关详细信息,请参阅 C# 编程指南中的顶级语句。
模式匹配增强功能
C# 9 包括新的模式匹配改进:
类型模式匹配一个与特定类型匹配的对象
带圆括号的模式强制或强调模式组合的优先级
联合 and
模式要求两个模式都匹配
析取 or
模式要求任一模式匹配
否定 not
模式要求模式不匹配
关系模式要求输入小于、大于、小于等于或大于等于给定常数。
这些模式丰富了模式的语法。 请考虑下列示例:
public static bool IsLetter(this char c) =>
c is >= 'a' and <= 'z' or >= 'A' and <= 'Z';
使用可选的括号来明确 and
的优先级高于 or
:
public static bool IsLetterOrSeparator(this char c) =>
c is (>= 'a' and <= 'z') or (>= 'A' and <= 'Z') or '.' or ',';
最常见的用途之一是用于 NULL 检查的新语法:
if (e is not null)
// ...
后面模式中的任何一种都可在允许使用模式的任何上下文中使用:is
模式表达式、switch
表达式、嵌套模式以及 switch
语句的 case
标签的模式。
有关详细信息,请查看模式(C# 参考)。
有关详细信息,请参阅模式一文中的关系模式和逻辑模式部分。
3 项新功能改进了对需要高性能的本机互操作性和低级别库的支持:本机大小的整数、函数指针和省略 localsinit
标志。
本机大小的整数 nint
和 nuint
是整数类型。 它们由基础类型 System.IntPtr 和 System.UIntPtr 表示。 编译器将这些类型的其他转换和操作作为本机整数公开。 本机大小的整数定义 MaxValue
或 MinValue
的属性。 这些值不能表示为编译时编译时,因为它们取决于目标计算机上整数的本机大小。 这些值在运行时是只读的。 可在以下范围内对 nint
使用常量值:[int.MinValue
.. int.MaxValue
]. 可在以下范围内对 nuint
使用常量值:[uint.MinValue
.. uint.MaxValue
]. 编译器使用 System.Int32 和 System.UInt32 类型为所有一元和二元运算符执行常量折叠。 如果结果不满足 32 位,操作将在运行时执行,且不会被视为常量。 在广泛使用整数数学且需要尽可能快的性能的情况下,本机大小的整数可提高性能。 有关详细信息,请参阅 nint
和 nuint
类型。
函数指针提供了一种简单的语法来访问 IL 操作码 ldftn
和 calli
。 可使用新的 delegate*
语法声明函数指针。 delegate*
类型是指针类型。 调用 delegate*
类型会使用 calli
,而不是使用在 Invoke()
方法上采用 callvirt
的委托。 从语法上讲,调用是相同的。 函数指针调用使用 managed
调用约定。 在 delegate*
语法后面添加 unmanaged
关键字,以声明想要 unmanaged
调用约定。 可使用 delegate*
声明中的属性来指定其他调用约定。 有关详细信息,请参阅不安全代码和指针类型。
最后,可添加 System.Runtime.CompilerServices.SkipLocalsInitAttribute 来指示编译器不要发出 localsinit
标志。 此标志指示 CLR 对所有局部变量进行零初始化。 从 1.0 开始,localsinit
标志一直是 C# 的默认行为。 但在某些情况下,额外的零初始化可能会对性能产生可衡量的影响, 特别是在使用 stackalloc
时。 在这些情况下,可添加 SkipLocalsInitAttribute。 可将它添加到单个方法或属性中,或者添加到 class
、struct
、interface
,甚至是模块中。 此属性不会影响 abstract
方法,它会影响为实现生成的代码。 有关详细信息,请参阅 SkipLocalsInit
属性。
这些功能在某些情况下可提高性能。 仅应在采用前后对这些功能进行仔细的基准测试之后使用它们。 涉及本机大小整数的代码必须在使用不同整数大小的多个目标平台上进行测试。 其他功能需要不安全的代码。
调整和完成功能
还有其他很多功能有助于更高效地编写代码。 在 C# 9.0 中,已知创建对象的类型时,可在 new
表达式中省略该类型。 最常见的用法是在字段声明中:
private List<WeatherObservation> _observations = new();
当需要创建新对象作为参数传递给方法时,也可使用目标类型 new
。 请考虑使用以下签名的 ForecastFor()
方法:
public WeatherForecast ForecastFor(DateTime forecastDate, WeatherForecastOptions options)
可按如下所示调用该方法:
var forecast = station.ForecastFor(DateTime.Now.AddDays(2), new());
此功能还有一个不错的用途是,将其与仅限 init 的属性组合使用来初始化新对象:
WeatherStation station = new() { Location = "Seattle, WA" };
可使用 return new();
语句返回由默认构造函数创建的实例。
类似的功能可改进条件表达式的目标类型解析。 进行此更改后,两个表达式无需从一个隐式转换到另一个,而是都可隐式转换为目标类型。 你可能不会注意到此更改。 你会注意到,某些以前需要强制转换或无法编译的条件表达式现在可以正常工作。
从 C# 9.0 开始,可将 static
修饰符添加到 Lambda 表达式或匿名方法。 静态 Lambda 表达式类似于 static
局部函数:静态 Lambda 或匿名方法无法捕获局部变量或实例状态。 static
修饰符可防止意外捕获其他变量。
协变返回类型为重写方法的返回类型提供了灵活性。 重写方法可返回从重写基方法的返回类型派生的类型。 这对于记录和其他支持虚拟克隆或工厂方法的类型很有用。
此外,foreach
循环将识别并使用扩展方法 GetEnumerator
,否则将满足 foreach
模式。 此更改意味着 foreach
与其他基于模式的构造(例如异步模式和基于模式的析构)一致。 实际上,此更改意味着可以为任何类型添加 foreach
支持。 在设计中,应将其限制为在枚举对象有意义时使用。
接下来,可使用弃元作为 Lambda 表达式的参数。 这样可免于为参数命名,并且编译器也可避免使用它。 可将 _
用于任何参数。 有关详细信息,请参阅 Lambda 表达式一文中的 Lambda 表达式的输入参数一节。
最后,现在可将属性应用于本地函数。 例如,可将可为空的属性注释应用于本地函数。
支持代码生成器
最后两项功能支持 C# 代码生成器。 C# 代码生成器是可编写的组件,类似于 roslyn 分析器或代码修补程序。 区别在于,代码生成器会在编译过程中分析代码并编写新的源代码文件。 典型的代码生成器会在代码中搜索属性或其他约定。
代码生成器使用 Roslyn 分析 API 读取属性或其他代码元素。 通过该信息,它将新代码添加到编译中。 源生成器只能添加代码,不能修改编译中的任何现有代码。
为代码生成器添加的两项功能是“分部方法语法”和“模块初始化表达式”的扩展。 首先是对分部方法的更改。 在 C# 9.0 之前,分部方法为 private
,但不能指定访问修饰符、不能返回 void
,也不能具有 out
参数。 这些限制意味着,如果未提供任何方法实现,编译器会删除对分部方法的所有调用。 C# 9.0 消除了这些限制,但要求分部方法声明必须具有实现。 代码生成器可提供这种实现。 为了避免引入中断性变更,编译器会考虑没有访问修饰符的任何分部方法,以遵循旧规则。 如果分部方法包括 private
访问修饰符,则由新规则控制该分部方法。 有关详细信息,请查看分部方法(C# 参考)。
代码生成器的第二项新功能是模块初始化表达式。 模块初始化表达式是附加了 ModuleInitializerAttribute 属性的方法。 在整个模块中进行任何其他字段访问或方法调用之前,运行时将调用这些方法。 模块初始化表达式方法:
必须是静态的
必须没有参数
必须返回 void
不能是泛型方法
不能包含在泛型类中
必须能够从包含模块访问
最后一个要点实际上意味着该方法及其包含类必须是内部的或公共的。 方法不能为本地函数。 有关详细信息,请参阅 ModuleInitializer
属性。