<system.codedom> 元素

项目
08/18/2008

更新：2007 年 11 月

指定可用语言提供程序的编译器配置设置。

<system.codedom>
  <compilers> ... </compilers>
</system.codedom>

属性和元素

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

属性

无。

子元素

元素	说明
<compilers>	编译器配置元素的容器；不包含或者包含多个 <compiler> 元素。

父元素

元素	说明
<configuration>	公共语言运行库和 .NET Framework 应用程序所使用的每个配置文件中的根元素。

备注

.NET Framework 2.0 版

<system.codedom> 元素除了包含随 .NET Framework 一起安装的默认提供程序（如 CSharpCodeProvider 和 VBCodeProvider）的编译器配置设置外，还包含计算机上安装的其他语言提供程序的编译器配置设置。<compilers> 元素包含零个或多个 <compiler> 元素。每个 <compiler> 元素为一个特定语言提供程序指定编译器配置属性。

开发人员和编译器供应商可以为新的 CodeDomProvider 实现在计算机配置文件 (Machine.config) 中添加配置设置。使用 CodeDomProvider.GetAllCompilerInfo 方法，可以通过编程方式同时枚举默认语言提供程序和由计算机上的编译器配置设置所标识的语言提供程序。

说明：
在 .NET Framework 1.0 和 1.1 版中，由 .NET Framework 提供的默认语言提供程序是在 <compilers> 元素中标识的。在 .NET Framework 2.0 版中，默认语言提供程序未在 <compilers> 元素中标识，但可以使用 GetAllCompilerInfo 方法来枚举。

.NET Framework 1.0 和 1.1 版

<system.codedom> 元素包含计算机上的语言提供程序的编译器配置设置。<compilers> 元素包含零个或多个 <compiler> 元素。每个 <compiler> 元素为一个特定语言提供程序指定编译器配置属性。

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

配置文件

此元素可以在计算机配置文件和应用程序配置文件中使用。

示例

下面的示例阐释了一个典型的编译器配置。

<configuration>
  <system.codedom>
    <compilers>
      <!-- zero or more compiler elements -->
      <compiler 
        language="c#;cs;csharp"
        extension=".cs"
        type="Microsoft.CSharp.CSharpCodeProvider, System, 
          Version=1.0.5000.0, Culture=neutral, 
          PublicKeyToken=b77a5c561934e089"
        compilerOptions=""
        warningLevel="1" />
    </compilers>
  </system.codedom>
</configuration>

请参见

参考

其他资源

.NET Framework 的配置文件架构