<elemento providerOption>

Artigo
04/06/2024

Especifica os atributos de versão do compilador para um provedor de idioma.

<configuração>
  <sistema.codedom>
    <Compiladores>
      <Compilador>
        <providerOption>

Sintaxe

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

Atributos e Elementos

As seções a seguir descrevem atributos, elementos filho e elementos pai.

Atributos

Atributo	Description
`name`	Atributo obrigatório. Especifica o nome da opção; por exemplo, "CompilerVersion".
`value`	Atributo obrigatório. Especifica o valor da opção; por exemplo, "v3.5".

Elementos Subordinados

Nenhum.

Elementos Principais

Elemento	Description
<Elemento de configuração>	O elemento raiz em cada arquivo de configuração que é usado pelo Common Language Runtime e aplicativos .NET Framework.
<Elemento system.codedom>	Especifica as definições de configuração do compilador para provedores de idiomas disponíveis.
<Elemento compiladores>	Container para elementos de configuração do compilador; contém zero ou mais `<compiler>` elementos.
<Elemento do compilador>	Especifica os atributos de configuração do compilador para um provedor de idioma.

Observações

No .NET Framework versão 3.5, os provedores de código CodeDOM (Code Document Object Model) podem oferecer suporte a opções específicas do provedor usando o <providerOption> elemento .

O .NET Framework 3.5 inclui assemblies atualizados do .NET Framework 2.0 e fornece assemblies da nova versão 3.5 que contêm novos tipos. Os provedores de código Microsoft C# e Visual Basic estão contidos em assemblies do .NET Framework 2.0, mas foram atualizados para oferecer suporte a compiladores da versão 3.5. Por padrão, os provedores de código atualizados geram código para compiladores da versão 2.0. Você pode usar o <providerOption> elemento para alterar a versão do compilador de destino para 3.5. Para fazer isso, especifique "CompilerVersion" para o name atributo e "v3.5" para o value atributo. Você deve preceder o número da versão com um "v" minúsculo.

Você pode tornar a especificação de versão global adicionando o <providerOption> elemento ao arquivo .NET Framework 2.0 Machine.config ou Web.config raiz. Se você atualizar a versão padrão do compilador para 3.5 no arquivo Machine.config, poderá alterá-la de volta para 2.0 por aplicativo usando o <providerOption> elemento no arquivo de configuração do aplicativo.

Os implementadores do provedor de código CodeDOM podem processar opções personalizadas fornecendo um construtor que usa um providerOptions parâmetro do tipo IDictionary<TKey,TValue>.

Exemplo

O exemplo a seguir demonstra como especificar que a versão 3.5 do provedor de código C# deve ser usada.

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

Partilhar via