指定语言提供程序的编译器配置属性。
<配置元素 > <system.codedom 元素 > <compilers 元素 ><编译器 > 元素
语法
<compiler
language="languageName[;...;...]"
extension="fileExtension[;...;...]"
type="typeName, assemblyName"
warningLevel="number"
compilerOptions="option1 option2"
/>
特性和元素
下列各节描述了特性、子元素和父元素。
特性
| 特性 | 描述 |
|---|---|
compilerOptions |
可选特性。 指定用于编译的其他特定于编译器的参数。 值compilerOptions属性通常编译器的编译器选项主题中列出。 |
extension |
必需的特性。 提供以分号分隔的语言提供程序的源文件所使用的文件扩展名的列表。 例如,".cs"。 |
language |
必需的特性。 提供语言提供程序支持的语言名称之间用分号分隔的列表。 例如,"c#; cs; csharp"。 |
type |
必需的特性。 指定语言提供程序,包括包含的提供程序实现的程序集名称的类型的名称。 类型名称必须满足中定义的要求指定完全限定的类型名称。 |
warningLevel |
可选特性。 指定的默认编译器警告等级;确定在该语言提供程序将编译警告视为错误的级别。 |
子元素
| 元素 | 描述 |
|---|---|
| <providerOption > 元素 | 指定语言提供程序的编译器版本特性。 |
父元素
| 元素 | 描述 |
|---|---|
| <configuration> 元素 | 公共语言运行时和 .NET Framework 应用程序所使用的每个配置文件中的根元素。 |
| <system.codedom > 元素 | 指定可用语言提供程序的编译器配置设置。 |
| <编译器 > 元素 | 编译器配置元素; 容器包含零个或多<compiler>元素。 |
备注
每个<compiler>元素指定特定的语言提供程序的编译器配置属性。 提供程序可扩展xref:System.CodeDom.Compiler.CodeDomProvider?displayProperty=nameWithType类的特定语言;<compiler>元素定义的编译器和语言提供程序的代码生成器设置。
.NET Framework 在计算机配置文件 (Machine.config) 中定义初始编译器设置。 开发人员和编译器供应商可以添加新 xref:System.CodeDom.Compiler.CodeDomProvider 实现的配置设置。 使用 xref:System.CodeDom.Compiler.CodeDomProvider.GetAllCompilerInfo*?displayProperty=nameWithType 方法,以编程方式枚举计算机上的语言提供程序和编译器配置设置。
在应用程序或 Web 配置文件的编译器元素可以补充或替代计算机配置文件中的设置。 如果为相同的语言名称或相同的文件扩展名配置了多个提供程序实现,最后一个匹配的配置将覆盖该语言名称或文件扩展的任何先前已配置提供程序。
配置文件
计算机配置文件和应用程序配置文件中,可以使用此元素。
示例
下面的示例演示一个典型的编译器配置元素:
<configuration>
<system.codedom>
<compilers>
<!-- zero or more compiler elements -->
<compiler
language="c#;cs;csharp"
extension=".cs"
type="Microsoft.CSharp.CSharpCodeProvider, System,
Version=2.0.3600.0, Culture=neutral,
PublicKeyToken=b77a5c561934e089"
compilerOptions="/optimize"
warningLevel="1" />
</compilers>
</system.codedom>
</configuration>
请参阅
- xref:System.CodeDom.Compiler.CompilerInfo
- xref:System.CodeDom.Compiler.CodeDomProvider
- 配置文件架构
- <编译器 > 元素
- 指定完全限定的类型名称
- (ASP.NET 设置架构) compilation 的 compilers 的 compiler 元素
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
