C# 语言版本控制

最新的 C# 编译器根据项目的一个或多个目标框架确定默认语言版本。 Visual Studio 不提供用于更改值的 UI，但可以通过编辑 .csproj 文件来更改值。 此默认选择可确保使用与目标框架兼容的最新语言版本。 你将从访问与项目目标兼容的最新语言功能中受益。 此默认选择还可确保不会使用需要类型或运行时行为在目标框架中不可用的语言。 选择比默认版本更高的语言版本可能导致难以诊断编译时和运行时错误。

C# 11 仅在 .NET 7 及更高版本上受支持。 C# 10 仅在 .NET 6 及更高版本上受支持。 C# 9 仅在 .NET 5 及更高版本上受支持。

有关 Visual Studio 版本支持的 NET 版本的详细信息，请查看 Visual Studio 平台兼容性页面。 有关 Visual Studio for Mac 版本支持的 NET 版本的详细信息，请查看 Visual Studio for Mac 平台兼容性页面。 查看 C# 的 Mono 页面，了解 Mono 与 C# 版本的兼容性。

默认值

编译器根据以下规则确定默认值：

如果你的项目是以具有相应预览语言版本的预览框架为目标，那么使用的语言版本是预览语言版本。 你可在任何环境中使用该预览版提供的最新功能，而不会影响面向已发布 .NET Core 版本的项目。

替代默认值

如果必须明确指定 C# 版本，可以通过以下几种方式实现：

• 手动编辑项目文件。
• 为子目录中的多个项目设置语言版本。
• 配置 LangVersion 编译器选项。

编辑项目文件

可在项目文件中设置语言版本。 例如，如果你明确希望访问预览功能，请添加如下元素：

<PropertyGroup>
   <LangVersion>preview</LangVersion>
</PropertyGroup>

值 preview 使用编译器支持的最新可用的预览 C# 语言版本。

配置多个项目

若要配置多个目录，可以创建包含 元素的 Directory.Build.props 文件。 通常是在解决方案目录中完成这件事。 将以下内容添加到解决方案目录中的 Directory.Build.props 文件：

<Project>
 <PropertyGroup>
   <LangVersion>preview</LangVersion>
 </PropertyGroup>
</Project>

包含该文件的目录的所有子目录中的版本都将使用 C# 预览版。 有关详细信息，请查看自定义生成。

C# 语言版本引用

下表显示当前所有 C# 语言版本。 如果编译器较旧，它可能不一定能识别每个值。 如果安装的是最新的 .NET SDK，则可以访问列出的所有内容。