Элемент <system.codedom>

Статья
11/16/2008

Обновлен: Ноябрь 2007

Задание параметров конфигурации компилятора для доступных поставщиков языков.

Элемент <configuration>
Элемент <system.codedom>

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

Атрибуты и элементы

В следующих разделах описываются атрибуты, дочерние и родительские элементы.

Атрибуты

Нет.

Дочерние элементы

Элемент	Описание
<compilers>	Контейнер для элементов конфигурации компилятора; может содержать любое число элементов <compiler>, включая ноль.

Родительские элементы

Элемент	Описание
<конфигурация>	Корневой элемент в любом файле конфигурации, используемом средой CLR и приложениями .NET Framework.

Заметки

.NET Framework версии 2.0

Элемент <system.codedom> содержит параметры конфигурации компилятора для поставщиков языков, установленных на компьютере дополнительно к поставщикам по умолчанию, установленным вместе с платформой .NET Framework, например CSharpCodeProvider и VBCodeProvider. Элемент <compilers> может содержать любое число элементов <compiler>, включая ноль. Каждый элемент <compiler> задает атрибуты конфигурации компилятора для конкретного поставщика языка.

Разработчики и поставщики компиляторов могут добавлять параметры конфигурации в файл конфигурации компьютера (Machine.config) для новой реализации CodeDomProvider. Используйте метод CodeDomProvider.GetAllCompilerInfo, чтобы программно перечислить поставщиков языка по умолчанию и поставщиков языка, указанных в параметрах конфигурации компилятора на компьютере.

Примечание.
В платформе .NET Framework версий 1.0 и 1.1 поставщики языка по умолчанию, устанавливаемые вместе с платформой .NET Framework, указываются в элементе <compilers>. В платформе .NET Framework версии 2.0 поставщики языка по умолчанию не указываются в элементе <compilers>, но могут быть перечислены с помощью метода 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>