<system.codedom> Element

Article
12/13/2007

Specifies compiler configuration settings for available language providers.

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

Attributes and Elements

The following sections describe attributes, child elements, and parent elements.

Attributes

None.

Child Elements

Element	Description
<compilers>	Container for compiler configuration elements; contains zero or more <compiler> elements.

Parent Elements

Element	Description
<configuration>	The root element in every configuration file used by the common language runtime and .NET Framework applications.

Remarks

.NET Framework Version 2.0

The <system.codedom> element contains compiler configuration settings for language providers installed on a computer in addition to the default providers that are installed with the .NET Framework, such as the CSharpCodeProvider and the VBCodeProvider. The <compilers> element contains zero or more <compiler> elements. Each <compiler> element specifies the compiler configuration attributes for a specific language provider.

Developers and compiler vendors can add configuration settings to the machine configuration file (Machine.config) for a new CodeDomProvider implementation. Use the System.CodeDom.Compiler.CodeDomProvider.GetAllCompilerInfo method to programmatically enumerate both the default language providers and language providers identified by the compiler configuration settings on a computer.

Note
In the .NET Framework versions 1.0 and 1.1, the default language providers supplied by the .NET Framework are identified in the <compilers> element. In the .NET Framework version 2.0, the default language providers are not identified in the <compilers> element, but can be enumerated using the GetAllCompilerInfo method.

.NET Framework Versions 1.0 and 1.1

The <system.codedom> element contains the compiler configuration settings for language providers on a computer. The <compilers> element contains zero or more <compiler> elements. Each <compiler> element specifies the compiler configuration attributes for a specific language provider.

The .NET Framework defines the initial compiler settings in the machine configuration file (Machine.config). Developers and compiler vendors can add configuration settings for a new CodeDomProvider implementation. Use the System.CodeDom.Compiler.CodeDomProvider.GetAllCompilerInfo method to programmatically enumerate language provider and compiler configuration settings on a computer.

Configuration File

This element can be used in the machine configuration file and the application configuration file.

Example

The following example illustrates a typical compiler configuration.

<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>