diff --git a/docs/csharp/language-reference/compiler-options/langversion-compiler-option.md b/docs/csharp/language-reference/compiler-options/langversion-compiler-option.md index d30ee9dbaf6eb..15ba27a3df3bc 100644 --- a/docs/csharp/language-reference/compiler-options/langversion-compiler-option.md +++ b/docs/csharp/language-reference/compiler-options/langversion-compiler-option.md @@ -47,15 +47,28 @@ Causes the compiler to accept only syntax that is included in the chosen C# lang |Option|Meaning| |------------|-------------| -|default|The compiler accepts all valid language syntax.| -|ISO-1|The compiler accepts only syntax that is included in the ISO/IEC 23270:2003 C# language specification.| -|ISO-2|The compiler accepts only syntax that is included in the ISO/IEC 23270:2006 C# language specification. This specification is available on the [ISO](http://go.microsoft.com/fwlink/?LinkId=144406) Web site.| -|3|The compiler accepts only syntax that is included in the version 3.0 [C# Language Specification](../../../csharp/language-reference/language-specification.md).| +|default|The compiler accepts all valid language syntax that it can support. [Default](#FDefault)| +|ISO-1|The compiler accepts only syntax that is included in ISO/IEC 23270:2003 C# (1.0/1.1) [ISO1](#FISO1)| +|ISO-2|The compiler accepts only syntax that is included in ISO/IEC 23270:2006 C# (2.0) [ISO2](#FISO2)| +|3|The compiler accepts only syntax that is included in C# 3.0 or lower [CS3](#FCS3)| +|4|The compiler accepts only syntax that is included in C# 4.0 or lower [CS4](#FCS4)| +|5|The compiler accepts only syntax that is included in C# 5.0 or lower [CS5](#FCS5)| +|6|The compiler accepts only syntax that is included in C# 6.0 or lower [CS6](#FCS6)| +|7|The compiler accepts only syntax that is included in C# 7.0 or lower [CS7](#FCS7)| +|latest|The compiler accepts all valid language syntax that it can support. [Latest](#FLatest)| + + ## Remarks Metadata referenced by your C# application is not subject to **/langversion** compiler option. Because each version of the C# compiler contains extensions to the language specification, **/langversion** does not give you the equivalent functionality of an earlier version of the compiler. + + Additionally, while C# version updates generally coincide with major .Net Framework releases, the new syntax and features are not necessarily tied to that specific framework version. While the new features will definitely require a new compiler update that is also released alongside the C# revision, each specific feature has it's own minimum .Net API or common language runtime requirements that may allow it to run on downlevel frameworks by including NuGet packages or other libraries. Regardless of which **/langversion** setting you use, you will use the current version of the common language runtime to create your .exe or .dll. One exception is friend assemblies and [/moduleassemblyname (C# Compiler Option)](../../../csharp/language-reference/compiler-options/moduleassemblyname-compiler-option.md), which work under **/langversion:ISO-1**. @@ -70,8 +83,39 @@ Causes the compiler to accept only syntax that is included in the chosen C# lang 4. Modify the **Language Version** property. For information about how to set this compiler option programmatically, see . - + ## See Also [C# Compiler Options](../../../csharp/language-reference/compiler-options/index.md) [NIB How to: Modify Project Properties and Configuration Settings](http://msdn.microsoft.com/en-us/e7184bc5-2f2b-4b4f-aa9a-3ecfcbc48b67) - [C# Language Specification](../../../csharp/language-reference/language-specification.md) \ No newline at end of file + +### C# Language Specification + [C# Language Specification Reference](../../../csharp/language-reference/language-specification.md) : .NET Foundation + C# 1.0/1.1 [ISO/IEC 23270:2003](https://www.iso.org/standard/36768.html) Information technology -- C# Language Specification : ISO Catalogue + C# 2.0 [ISO/IEC 23270:2006](https://www.iso.org/standard/42926.html) Information technology -- C# Language Specification : ISO Catalogue + C# 2.0 [c042926_ISO_IEC_23270_2006(E).zip](http://go.microsoft.com/fwlink/?LinkId=144406) ISO/IEC 23270:2006 in PDF format : ISO Freely Available Standards + C# 3.0 [CSharp Language Specification.doc](http://download.microsoft.com/download/3/8/8/388e7205-bc10-4226-b2a8-75351c669b09/CSharp%20Language%20Specification.doc) C# Language Specification Version 3.0 : Microsoft Corporation + C# 4.0 [Ecma-334.pdf](https://www.ecma-international.org/publications/files/ECMA-ST/Ecma-334.pdf) Standard ECMA-334 4th Edition + C# 5.0 [CSharp Language Specification.docx](www.microsoft.com/en-us/download/details.aspx?id=7029) C# Language Specification Version 5.0 : Microsoft Corporation + C# 6.0 [README.md](https://github.com/dotnet/csharplang/blob/master/spec/README.md) C# Language Specification Version 6 - Unofficial Draft : .NET Foundation + C# 7.0 (not currently available) + + + +### Minimum compiler version needed to support all language features +[↩](#TDefault)Default, ISO1: Microsoft Visual Studio/Build Tools .Net 2002 or bundled .Net Framework 1.0 compiler +[↩](#TISO2)ISO2: Microsoft Visual Studio/Build Tools 2005 or bundled .Net Framework 2.0 compiler +[↩](#TCS3)CS3: Microsoft Visual Studio/Build Tools 2008 or bundled .Net Framework 3.5 compiler +[↩](#TCS4)CS4: Microsoft Visual Studio/Build Tools 2010 or bundled .Net Framework 4.0 compiler +[↩](#TCS5)CS5: Microsoft Visual Studio/Build Tools 2012 or bundled .Net Framework 4.5 compiler +[↩](#TCS6)CS6: Microsoft Visual Studio/Build Tools 2015 +[↩](#TCS7)CS7, Latest: Microsoft Visual Studio/Build Tools 2017 + + diff --git a/docs/csharp/language-reference/compiler-options/listed-alphabetically.md b/docs/csharp/language-reference/compiler-options/listed-alphabetically.md index edf39e1e06e87..d45995f9f2b30 100644 --- a/docs/csharp/language-reference/compiler-options/listed-alphabetically.md +++ b/docs/csharp/language-reference/compiler-options/listed-alphabetically.md @@ -59,7 +59,7 @@ The following compiler options are sorted alphabetically. For a categorical list |**/incremental**|Enables incremental compilation [obsolete].| |[/keycontainer](../../../csharp/language-reference/compiler-options/keycontainer-compiler-option.md)|Specifies a strong name key container.| |[/keyfile](../../../csharp/language-reference/compiler-options/keyfile-compiler-option.md)|Specifies a strong name key file.| -|[/langversion:\](../../../csharp/language-reference/compiler-options/langversion-compiler-option.md)|Specify language version mode: ISO-1, ISO-2, 3, 4, 5, 6, or Default| +|[/langversion:\](../../../csharp/language-reference/compiler-options/langversion-compiler-option.md)|Specify language version mode: Default, ISO-1, ISO-2, 3, 4, 5, 6, 7, 7.1, or Latest | |[/lib](../../../csharp/language-reference/compiler-options/lib-compiler-option.md)|Specifies additional directories in which to search for references.| |[/link](../../../csharp/language-reference/compiler-options/link-compiler-option.md)|Makes COM type information in specified assemblies available to the project.| |[/linkresource](../../../csharp/language-reference/compiler-options/linkresource-compiler-option.md)|Links the specified resource to this assembly.| @@ -95,4 +95,4 @@ The following compiler options are sorted alphabetically. For a categorical list [C# Compiler Options](../../../csharp/language-reference/compiler-options/index.md) [C# Compiler Options Listed by Category](../../../csharp/language-reference/compiler-options/listed-by-category.md) [How to: Set Environment Variables for the Visual Studio Command Line](../../../csharp/language-reference/compiler-options/how-to-set-environment-variables-for-the-visual-studio-command-line.md) - [\ Element](../../../framework/configure-apps/file-schema/compiler/compiler-element.md) \ No newline at end of file + [\ Element](../../../framework/configure-apps/file-schema/compiler/compiler-element.md) diff --git a/docs/csharp/language-reference/compiler-options/listed-by-category.md b/docs/csharp/language-reference/compiler-options/listed-by-category.md index 4ccfb55c41eba..eee1e6281654e 100644 --- a/docs/csharp/language-reference/compiler-options/listed-by-category.md +++ b/docs/csharp/language-reference/compiler-options/listed-by-category.md @@ -106,7 +106,7 @@ The following compiler options are sorted by category. For an alphabetical list, |[/codepage](../../../csharp/language-reference/compiler-options/codepage-compiler-option.md)|Specifies the code page to use for all source code files in the compilation.| |[/help](../../../csharp/language-reference/compiler-options/help-compiler-option.md)|Lists compiler options to stdout.| |[/highentropyva](../../../csharp/language-reference/compiler-options/highentropyva-compiler-option.md)|Specifies that the executable file supports address space layout randomization (ASLR).| -|[/langversion](../../../csharp/language-reference/compiler-options/langversion-compiler-option.md)|Specify language version mode: ISO-1, ISO-2, 3, 4, 5, 6, or Default| +|[/langversion](../../../csharp/language-reference/compiler-options/langversion-compiler-option.md)|Specify language version mode: Default, ISO-1, ISO-2, 3, 4, 5, 6, 7, 7.1, or Latest | |[/main](../../../csharp/language-reference/compiler-options/main-compiler-option.md)|Specifies the location of the **Main** method.| |[/noconfig](../../../csharp/language-reference/compiler-options/noconfig-compiler-option.md)|Instructs the compiler not to compile with csc.rsp.| |[/nologo](../../../csharp/language-reference/compiler-options/nologo-compiler-option.md)|Suppresses compiler banner information.| @@ -126,4 +126,4 @@ The following compiler options are sorted by category. For an alphabetical list, ## See Also [C# Compiler Options](../../../csharp/language-reference/compiler-options/index.md) [C# Compiler Options Listed Alphabetically](../../../csharp/language-reference/compiler-options/listed-alphabetically.md) - [How to: Set Environment Variables for the Visual Studio Command Line](../../../csharp/language-reference/compiler-options/how-to-set-environment-variables-for-the-visual-studio-command-line.md) \ No newline at end of file + [How to: Set Environment Variables for the Visual Studio Command Line](../../../csharp/language-reference/compiler-options/how-to-set-environment-variables-for-the-visual-studio-command-line.md)