最新的 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# 版本的兼容性。
编译器根据以下规则确定默认值:
C# 语言版本的默认值
如果你的项目是以具有相应预览语言版本的预览框架为目标,那么使用的语言版本是预览语言版本。 你可在任何环境中使用该预览版提供的最新功能,而不会影响面向已发布 .NET Core 版本的项目。
Visual Studio 2017 的新项目模板向新项目文件添加了一个
<LangVersion>latest</LangVersion>
条目。 如果你升级这些项目的目标框架,则它们
替代默认行为
。 更新 .NET SDK 时,应从项目文件中删除
<LangVersion>latest</LangVersion>
。 然后项目将使用建议用于目标框架的编译器版本。 可更新目标框架以访问更新的语言功能。
替代默认值
如果必须明确指定 C# 版本,可以通过以下几种方式实现:
手动编辑
项目文件
。
为
子目录中的多个项目
设置语言版本。
配置
LangVersion 编译器选项
。
可以在“项目属性”页查看 Visual Studio 中的语言版本。 在“生成”选项卡下,“高级”窗格将显示所选版本。
若要了解当前使用的语言版本,请在代码中添加
#error version
(区分大小写)。 这样做可使编译器报告编译器错误 CS8304,并显示一条消息,其中包含正在使用的编译器版本和当前选择的语言版本。 有关详细信息,请参阅
#error(C# 参考)
。
编辑项目文件
可在项目文件中设置语言版本。 例如,如果你明确希望访问预览功能,请添加如下元素:
<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,则可以访问列出的所有内容。