Partilhar via


<providerOption> Elemento

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

<configuração>
   <system.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.

Attributes

Attribute 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 ficheiro de configuração utilizado pelas aplicações de runtime da linguagem comum e .NET Framework.
<system.codedom> Elemento Especifica as definições de configuração do compilador para os fornecedores de linguagens disponíveis.
<compiladores> Elemento Contentor 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 fornecedor de linguagem.

Observações

No .NET Framework versão 3.5, os fornecedores de código Code Document Object Model (CodeDOM) podem suportar opções específicas de cada fornecedor utilizando o <providerOption> elemento.

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

Pode tornar a especificação de versão global adicionando o <providerOption> elemento ao ficheiro Machine.config do .NET Framework 2.0 ou ao Web.config root. Se atualizar a versão padrão do compilador para 3.5 no ficheiro Machine.config, pode voltar a ser 2.0 por aplicação usando o <providerOption> elemento no ficheiro de configuração da aplicação.

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

Example

O exemplo seguinte demonstra como especificar que a versão 3.5 do fornecedor 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>

Consulte também