Элемент <providerOption><providerOption> Element

Указывает атрибуты версии компилятора для поставщика языка.Specifies the compiler version attributes for a language provider.

<configuration>
  <system.codedom>
    <compilers>
      <compiler>
        <providerOption>

СинтаксисSyntax

<providerOption  
  name="option-name"  
  value="option-value"  
/>  

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

В следующих разделах описаны атрибуты, дочерние и родительские элементы.The following sections describe attributes, child elements, and parent elements.

АтрибутыAttributes

АтрибутAttribute ОписаниеDescription
name Обязательный атрибут.Required attribute.

Указывает имя параметра. Например, "Компилерверсион".Specifies the name of the option; for example, "CompilerVersion".
value Обязательный атрибут.Required attribute.

Задает значение для параметра; Например, "v 3.5".Specifies the value for the option; for example, "v3.5".

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

Отсутствует.None.

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

ЭлементElement ОписаниеDescription
<configuration> Элемент<configuration> Element Корневой элемент в любом файле конфигурации, который используется средой CLR и приложениями .NET Framework.The root element in every configuration file that is used by the common language runtime and .NET Framework applications.
<system.codedom> Элемент<system.codedom> Element Задает параметры конфигурации компилятора для доступных поставщиков языков.Specifies compiler configuration settings for available language providers.
<compilers> Элемент<compilers> Element Контейнер для элементов конфигурации компилятора; содержит ноль или более <compiler> элементов.Container for compiler configuration elements; contains zero or more <compiler> elements.
<compiler> Элемент<compiler> Element Задает атрибуты конфигурации компилятора для поставщика языка.Specifies the compiler configuration attributes for a language provider.

RemarksRemarks

В .NET Framework версии 3,5 поставщики кода Code Document Object Model (CodeDOM) могут поддерживать параметры, зависящие от поставщика, с помощью <providerOption> элемента.In the .NET Framework version 3.5, Code Document Object Model (CodeDOM) code providers can support provider-specific options by using the <providerOption> element.

.NET Framework 3,5 включает обновленные сборки .NET Framework 2,0 и предоставляет новые сборки версии 3,5, содержащие новые типы.The .NET Framework 3.5 includes updated .NET Framework 2.0 assemblies and provides new version 3.5 assemblies that contain new types. Поставщики кода Microsoft C# и Visual Basic содержатся в сборках .NET Framework 2,0, но были обновлены для поддержки компиляторов версии 3,5.The Microsoft C# and Visual Basic code providers are contained in .NET Framework 2.0 assemblies but have been updated to support version 3.5 compilers. По умолчанию обновленные поставщики кода создают код для компиляторов версии 2,0.By default, the updated code providers generate code for version 2.0 compilers. С помощью элемента можно <providerOption> изменить целевую версию компилятора на 3,5.You can use the <providerOption> element to change the target compiler version to 3.5. Для этого укажите для атрибута значение "Компилерверсион" name и "v 3.5" value .To do this, specify "CompilerVersion" for the name attribute and "v3.5" for the value attribute. Перед номером версии необходимо указать строчную букву "v".You must precede the version number with a lower-case "v".

Глобальную спецификацию версии можно сделать, добавив <providerOption> элемент в Machine.config .NET Framework 2,0 или корневой Web.config файл.You can make the version specification global by adding the <providerOption> element to the .NET Framework 2.0 Machine.config or root Web.config file. Если вы обновляете версию компилятора по умолчанию до 3,5 в файле Machine.config, вы можете изменить ее обратно на 2,0 для каждого приложения, используя <providerOption> элемент в файле конфигурации приложения.If you update the default compiler version to 3.5 in the Machine.config file, you can change it back to 2.0 on a per-application basis by using the <providerOption> element in the application configuration file.

Разработчики поставщика кода CodeDOM могут обрабатывать пользовательские параметры, предоставляя конструктор, принимающий providerOptions параметр типа IDictionary<TKey,TValue> .CodeDOM code provider implementers can process custom options by providing a constructor that takes a providerOptions parameter of type IDictionary<TKey,TValue>.

ПримерExample

В следующем примере показано, как указать, что должен использоваться поставщик кода C# версии 3,5.The following example demonstrates how to specify that version 3.5 of the C# code provider should be used.

<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" >  
          <providerOption  
            name="CompilerVersion"  
            value="v3.5" />  
      </compiler>  
    </compilers>  
  </system.codedom>  
</configuration>  

См. такжеSee also