配置 C# 语言版本

警告

不建议将 LangVersion 元素设置为 latest。 latest 设置意味着已安装的编译器将使用其最新版本。这可以在计算机之间进行更改，从而使得生成不可靠。此外，它还支持可能需要当前 SDK 中不包含的运行时或库功能的语言功能。

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

提示

可以在“项目属性”页查看 Visual Studio 中的语言版本。在“生成”选项卡下，“高级”窗格将显示所选版本。

若要了解当前使用的语言版本，请在代码中添加 #error version（区分大小写）。这样做可使编译器报告编译器错误 CS8304，并显示一条消息，其中包含正在使用的编译器版本和当前选择的语言版本。有关详细信息，请参阅 #error（C# 参考）。

编辑项目文件

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

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

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

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

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

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

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

值	含义
`preview`	编译器接受最新预览版中的所有有效语言语法。
`latest`	编译器接受最新发布的编译器版本（包括次要版本）中的语法。
`latestMajor` 或 `default`	编译器接受最新发布的编译器主要版本中的语法。
`13.0`	编译器只接受 C# 13 或更低版本中所含的语法。
`12.0`	编译器只接受 C# 12 或更低版本中所含的语法。
`11.0`	编译器只接受 C# 11 或更低版本中包含的语法。
`10.0`	编译器只接受 C# 10 或更低版本中所含的语法。
`9.0`	编译器只接受 C# 9 或更低版本中所含的语法。
`8.0`	编译器只接受 C# 8.0 或更低版本中所含的语法。
`7.3`	编译器只接受 C# 7.3 或更低版本中所含的语法。
`7.2`	编译器只接受 C# 7.2 或更低版本中所含的语法。
`7.1`	编译器只接受 C# 7.1 或更低版本中所含的语法。
`7`	编译器只接受 C# 7.0 或更低版本中所含的语法。
`6`	编译器只接受 C# 6.0 或更低版本中所含的语法。
`5`	编译器只接受 C# 5.0 或更低版本中所含的语法。
`4`	编译器只接受 C# 4.0 或更低版本中所含的语法。
`3`	编译器只接受 C# 3.0 或更低版本中所含的语法。
`ISO-2` 或 `2`	编译器只接受 ISO/IEC 23270:2006 C# (2.0) 中所含的语法。
`ISO-1` 或 `1`	编译器只接受 ISO/IEC 23270:2003 C# (1.0/1.2) 中所含的语法。