Compartilhar via


Elemento <providerOption>

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

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

Syntax

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

Atributos e elementos

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

Atributos

Atributo Descrição
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 filho

Nenhum.

Elementos pai

Elemento Descrição
Elemento <configuration> O elemento raiz em todos os arquivos de configuração que é usado pelo common language runtime e aplicativos do .NET Framework.
Elemento <system.codedom> Especifica as definições de configuração do compilador para provedores de linguagem disponíveis.
<Elemento compilers> Contêiner de elementos de configuração do compilador. Contém zero ou mais elementos <compiler>.
Elemento <compiler> Especifica os atributos de configuração do compilador para um provedor de linguagem.

Comentários

No .NET Framework versão 3.5, os provedores de código codeDOM (CodeDOM) podem permitir opções específicas do provedor usando o elemento <providerOption>.

O .NET Framework 3.5 inclui assemblies atualizados .NET Framework 2.0 e fornece assemblies da nova versão 3.5 que contêm novos tipos. Os provedores de código do Microsoft C# e do Visual Basic estão contidos em assemblies 2.0 do .NET Framework, mas foram atualizados para oferecer compatibilidade com os 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 elemento <providerOption> para alterar a versão do compilador de destino para 3.5. Para fazer isso, especifique "CompilerVersion" para o atributo name e "v3.5" para o atributo value. Você precisa preceder o número de versão com um "v" de minúsculas.

Você pode tornar a especificação de versão global adicionando o elemento <providerOption> ao Machine.config do .NET Framework 2.0 ou ao arquivo de configuração raiz Web.config. Se você atualizar a versão do compilador padrão para 3.5 no arquivo Machine.config, poderá retorná-la para 2.0 de acordo com o aplicativo usando o elemento <providerOption> 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 parâmetro providerOptions 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>  

Confira também