大网数据广告活动
.NET 与 C# 开发

-langversion(C# 编译器选项)

· 52CE 我爱测

每个版本的 C# 编译器都包含语言规范的扩展,因此 -langversion 不提供早期版本编译器的同等功能。

使编译器仅接受包含在所选 C# 语言规范中的语法。

语法

-langversion:option  

自变量

option
以下为有效值:

选项 含义
preview 编译器接受它可支持的最新预览版本中的所有有效语言语法。
最新 编译器接受它可支持的最新版本(包括次要版本)中的所有有效语言语法。
latestMajor 编译器接受它可支持的最新主版本中的所有有效语言语法。
8.0 编译器只接受 C# 8.0 或更低版本中所含的语法。 <sup id="TCS80">CS80</sup>
7.3 编译器只接受 C# 7.3 或更低版本中所含的语法 <sup id="TCS73">CS73</sup>
7.2 编译器只接受 C# 7.2 或更低版本中所含的语法 <sup id="TCS72">CS72</sup>
7.1 编译器只接受 C# 7.1 或更低版本中所含的语法 <sup id="TCS71">CS71</sup>
7 编译器只接受 C# 7.0 或更低版本中所含的语法 <sup id="TCS7">CS7</sup>
6 编译器只接受 C# 6.0 或更低版本中所含的语法 <sup id="TCS6">CS6</sup>
5 编译器只接受 C# 5.0 或更低版本中所含的语法 <sup id="TCS5">CS5</sup>
4 编译器只接受 C# 4.0 或更低版本中所含的语法 <sup id="TCS4">CS4</sup>
3 编译器只接受 C# 3.0 或更低版本中所含的语法 <sup id="TCS3">CS3</sup>
ISO-2 编译器只接受 ISO/IEC 23270:2006 C# (2.0) 中所含的语法 <sup id="TISO2">ISO2</sup>
ISO-1 编译器只接受 ISO/IEC 23270:2003 C# (1.0/1.2) 中所含的语法 <sup id="TISO1">ISO1</sup>

备注

C# 应用程序引用的元数据不受 -langversion 编译器选项约束。

每个版本的 C# 编译器都包含语言规范的扩展,因此 -langversion 不提供早期版本编译器的同等功能。

此外,虽然 C# 版本更新通常与主要的 .NET Framework 版本一致,但新的语法和功能不一定绑定到该特定的 Framework 版本。 虽然新功能肯定需要与 C# 修订版一起发布的新编译器更新,但每项具体功能都有自己的最小 .NET API 或公共语言运行时要求,这些要求通过包括 NuGet 包或其他库允许功能在下层框架上运行。

无论使用哪一项 -langversion 设置,都将使用当前版本的公共语言运行时来创建 .exe 或 .dll。 友元程序集和 -moduleassemblyname(C# 编译器选项)是一个例外,它们在 -langversion:ISO-1 下工作。

若要了解指定 C# 语言版本的其他方式,请参阅选择 C# 语言版本主题。

有关如何以编程方式设置此编译器选项的信息,请参阅 xref:VSLangProj80.CSharpProjectConfigurationProperties3.LanguageVersion*。

请参阅

C# 语言规范

Version 链接 说明
C# 7.0 和更高版本 当前不可用
C# 6.0 链接 C# 语言规范版本 6 - 非官方草稿:.NET Foundation
C# 5.0 下载 PDF 标准 ECMA-334 第 5 版
C# 3.0 下载 DOC C# 语言规范版本 3.0:Microsoft Corporation
C# 2.0 下载 PDF 标准 ECMA-334 第 4 版
C# 1.2 下载 DOC C# 语言规范版本 1.2:Microsoft Corporation
C# 1.0 下载 DOC C# 语言规范版本 1.0:Microsoft Corporation

支持所有语言功能所需的最低编译器版本

↩CS80:Microsoft Visual Studio/生成工具 2019,版本 16 或 .NET Core 3.0 SDK
↩CS73:Microsoft Visual Studio/生成工具 2017,版本 15.7
↩CS72:Microsoft Visual Studio/生成工具 2017,版本 15.5
↩CS71:Microsoft Visual Studio/生成工具 2017,版本 15.3
↩CS7:Microsoft Visual Studio/生成工具 2017
↩CS6:Microsoft Visual Studio/生成工具 2015
↩CS5:Microsoft Visual Studio/生成工具 2012 或捆绑的 .NET Framework 4.5 编译器
↩CS4:Microsoft Visual Studio/生成工具 2010 或捆绑的 .NET Framework 4.0 编译器
↩CS3:Microsoft Visual Studio/生成工具 2008 或捆绑的 .NET Framework 3.5 编译器
↩ISO2:Microsoft Visual Studio/生成工具 2005 或捆绑的 .Net Framework 2.0 编译器
↩ISO1:Microsoft Visual Studio/生成工具 .NET 2002 或捆绑的 .Net Framework 1.0 编译器

历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 05/14/2018
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。