<Elemento do compilador>

Artigo
04/06/2024

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

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

Sintaxe

<compiler
  language="languageName[;...;...]"
  extension="fileExtension[;...;...]"
  type="typeName, assemblyName"
  warningLevel="number"
  compilerOptions="option1 option2"
/>

Atributos e Elementos

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

Atributos

Atributo	Description
`compilerOptions`	Atributo opcional. Especifica argumentos adicionais específicos do compilador para compilação. Os valores para o `compilerOptions` atributo são normalmente listados em um tópico de opções do compilador para o compilador.
`extension`	Atributo obrigatório. Fornece uma lista separada por ponto-e-vírgula de extensões de nome de arquivo usadas por arquivos de origem para o provedor de idiomas. Por exemplo, ".cs".
`language`	Atributo obrigatório. Fornece uma lista separada por ponto-e-vírgula de nomes de idiomas suportados pelo provedor de idiomas. Por exemplo, "c#; CS; csharp".
`type`	Atributo obrigatório. Especifica o nome do tipo do provedor de idioma, incluindo o nome do assembly que contém a implementação do provedor. O nome do tipo deve atender aos requisitos definidos em Especificando nomes de tipo totalmente qualificados.
`warningLevel`	Atributo opcional. Especifica o nível de aviso padrão do compilador; Determina o nível em que o provedor de idiomas trata os avisos de compilação como erros.

Elementos Subordinados

Elemento	Description
<elemento providerOption>	Especifica os atributos de versão do compilador para um provedor de idioma.

Elementos Principais

Elemento	Description
<Elemento de configuração>	O elemento raiz em cada arquivo de configuração 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.

Observações

Cada <compiler> elemento especifica os atributos de configuração do compilador para um provedor de idioma específico. O provedor estende a System.CodeDom.Compiler.CodeDomProvider classe para um idioma específico, o <compiler> elemento define as configurações do compilador e do gerador de código para o provedor de idioma.

O .NET Framework define as configurações iniciais do compilador no arquivo de configuração da máquina (Machine.config). Desenvolvedores e fornecedores de compiladores podem adicionar definições de configuração para uma nova CodeDomProvider implementação. Use o método para enumerar programaticamente as definições de configuração do CodeDomProvider.GetAllCompilerInfo provedor de linguagem e do compilador em um computador.

Os elementos do compilador no aplicativo ou no arquivo de configuração da Web podem complementar ou substituir as configurações no arquivo de configuração da máquina. Se mais de uma implementação de provedor estiver configurada para o mesmo nome de idioma ou a mesma extensão de arquivo, a última configuração correspondente substituirá qualquer provedor configurado anteriormente para esse nome de idioma ou extensão de arquivo.

Arquivo de configuração

Este elemento pode ser usado no arquivo de configuração da máquina e no arquivo de configuração do aplicativo.

Exemplo

O exemplo a seguir ilustra um elemento de configuração típico do compilador:

<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" />
    </compilers>
  </system.codedom>
</configuration>

Partilhar via