<compiler> 元素

项目
08/18/2008

更新：2007 年 11 月

指定语言提供程序的编译器配置属性。

<configuration> 元素
   <system.codedom> 元素
     <compilers> 元素
       <compiler> 元素

<compiler
  language="languageName[;...;...]"
  extension="fileExtension[;...;...]"
  type="typeName, assemblyName"
  warningLevel="number"
  compilerOptions="option1 option2"
/>

属性和元素

以下几节描述了属性、子元素和父元素。

属性

属性	说明
compilerOptions	可选。为编译指定附加的编译器特定参数。compilerOptions 属性的值通常列出在编译器的编译器选项主题中。在 Visual Studio 2005 文档中，可通过在索引中查找“编译器选项”来查找编译器选项。
extension	必需。提供语言提供程序的源文件使用的文件扩展名的分号分隔列表。例如“.cs”。
language	必需。提供语言提供程序支持的语言名称的分号分隔列表。例如，“c#;cs;csharp”。
type	必需。指定语言提供程序的类型名称，包括包含提供程序实现的程序集的名称。类型名称必须满足在指定完全限定类型名称中定义的要求。
warningLevel	可选。指定默认编译器警告级别；确定语言提供程序将编译警告视为错误的级别。

子元素

无。

父元素

元素	说明
<configuration> 元素	公共语言运行库和 .NET Framework 应用程序所使用的每个配置文件中的根元素。
<system.codedom> 元素	指定可用语言提供程序的编译器配置设置。
<compilers> 元素	编译器配置元素的容器；不包含或者包含多个 <compiler> 元素。

备注

每个 <compiler> 元素为一个特定语言提供程序指定编译器配置属性。提供程序为特定语言扩展 System.CodeDom.Compiler.CodeDomProvider 类；<compiler> 元素为语言提供程序定义编译器和代码生成器设置。

.NET Framework 在计算机配置文件 (Machine.config) 中定义初始编译器设置。开发人员和编译器供应商可以为新的 CodeDomProvider 实现添加配置设置。使用 CodeDomProvider.GetAllCompilerInfo 方法可在计算机上以编程方式枚举语言提供程序和编译器配置设置。

应用程序或 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>

请参见

通过

<compiler> 元素

属性和元素

属性

子元素

父元素

备注

配置文件

示例

请参见

概念

参考

其他资源

其他资源