配置 C# 语言版本

本文中的信息适用于 .NET 5 及更高版本。 对于 UWP 项目，请参阅有关 选择 UWP 版本的文章中的此信息。

在 Visual Studio 中，禁用通过 UI 更改语言版本的选项，因为默认版本与项目的目标框架 （TFM） 保持一致。 该默认配置确保语言特性与运行时支持的兼容性 若要在 Visual Studio 中更改语言版本，请更改项目的目标框架。

例如，将目标 TFM （例如，从 .NET 6 更改为 .NET 9）相应地更新语言版本，从 C# 10 更新为 C# 13。 该方法可防止运行时兼容性问题，并最大程度减少因不受支持语言特性导致的意外构建错误

如果需要与自动选择的语言版本不同的特定语言版本，请参阅本文中的方法，直接替代项目文件中的默认设置。

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

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

编辑项目文件

可在项目文件中设置语言版本。 项目文件是 *.csproj 项目根文件夹中的文件。 例如，如果显式想要访问预览功能，请添加如下例所示的元素：

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

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

配置多个项目

若要配置多个 C# 项目，可以创建一个 Directory.Build.props 文件（通常位于解决方案目录中），其中包含 <LangVersion> 该元素。 将以下设置添加到 Directory.Build.props 文件：

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

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

C# 语言版本引用

下表显示当前所有 C# 语言版本。 较旧的编译器可能无法理解每个值。 如果安装了最新的 .NET SDK，则可以访问列出的所有内容。