C# 编译器根据项目的一个或多个目标框架确定默认语言版本。 这是因为 C# 语言可能具有依赖于每个 .NET 实现中不提供的类型或运行时组件的功能。 这也确保了无论根据哪种目标构建项目,默认情况下你都将获得最兼容的语言版本。
默认值
编译器根据以下规则确定默认值:
| 目标框架 | version | C# 语言版本的默认值 |
|---|---|---|
| .NET Core | 3.x | C# 8.0 |
| .NET Core | 2.x | C# 7.3 |
| .NET Standard | 全部 | C# 7.3 |
| .NET Framework | 全部 | C# 7.3 |
默认值适用于预览版
如果你的项目是以具有相应预览语言版本的预览框架为目标,那么使用的语言版本是预览语言版本。 这可确保你可以使用保证在任何环境中都可用的预览提供的最新功能,而不会影响面向发布的 .NET Core 版本的项目。
替代默认值
如果必须明确指定 C# 版本,可以通过以下几种方式实现:
- 手动编辑项目文件。
- 为子目录中的多个项目设置语言版本。
- 配置
-langversion编译器选项
编辑项目文件
可在项目文件中设置语言版本。 例如,如果你明确希望访问预览功能,请添加如下元素:
<PropertyGroup>
<LangVersion>preview</LangVersion>
</PropertyGroup>
值 preview 使用编译器支持的最新可用的预览 C# 语言版本。
配置多个项目
可以创建包含 <LangVersion> 元素的 Directory.Build.props 文件来配置多个目录。 通常是在解决方案目录中完成这件事。 将以下内容添加到解决方案目录中的 Directory.Build.props 文件:
<Project>
<PropertyGroup>
<LangVersion>preview</LangVersion>
</PropertyGroup>
</Project>
现在,包含该文件的目录的每个子目录中的版本都将使用 C# 预览版。 有关详细信息,请参阅关于自定义生成的文章。
C# 语言版本引用
下表显示当前所有 C# 语言版本。 如果编译器较旧,它可能不一定了解每个值。 如果安装的是 .NET Core 3.0,则你可以访问列出的所有内容。
| 值 | 含义 |
|---|---|
| preview | 编译器接受最新预览版中的所有有效语言语法。 |
| 最新 | 编译器接受最新发布的编译器版本(包括次要版本)中的语法。 |
| latestMajor | 编译器接受最新发布的编译器主要版本中的语法。 |
| 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 | 编译器只接受 ISO/IEC 23270:2006 C# (2.0) 中所含的语法 |
| ISO-1 | 编译器只接受 ISO/IEC 23270:2003 C# (1.0/1.2) 中所含的语法 |
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
