Edit

Share via


<system.codedom> Element

Specifies compiler configuration settings for available language providers.

<configuration>
  <system.codedom>

Syntax

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

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

See also