<Elemento > do compilador<compiler> Element

Especifica os atributos de configuração do compilador para um provedor de linguagem.Specifies the compiler configuration attributes for a language provider.

<configuration> <configuration>
   <> System. CodeDom  <system.codedom>
     <compiladores >     <compilers>
       <> do compilador      <compiler>

SintaxeSyntax

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

Atributos e elementosAttributes and Elements

As seções a seguir descrevem atributos, elementos filho e elementos pai.The following sections describe attributes, child elements, and parent elements.

AtributosAttributes

AtributoAttribute DescriçãoDescription
compilerOptions Atributo opcional.Optional attribute.

Especifica argumentos adicionais específicos do compilador para compilação.Specifies additional compiler-specific arguments for compilation. Os valores para o compilerOptions atributo são normalmente listados em um tópico de opções de compilador para o compilador.The values for the compilerOptions attribute are typically listed in a compiler options topic for the compiler.
extension Atributo obrigatório.Required attribute.

Fornece uma lista separada por ponto-e-vírgula das extensões de nome de arquivo usadas pelos arquivos de origem para o provedor de idiomas.Provides a semicolon-separated list of file name extensions used by source files for the language provider. Por exemplo, ".cs".For example, ".cs".
language Atributo obrigatório.Required attribute.

Fornece uma lista separada por ponto-e-vírgula de nomes de idiomas com suporte pelo provedor de idiomas.Provides a semicolon-separated list of language names supported by the language provider. Por exemplo, "C#;cs;csharp".For example, "c#;cs;csharp".
type Atributo obrigatório.Required attribute.

Especifica o nome do tipo do provedor de idioma, incluindo o nome do assembly que contém a implementação do provedor.Specifies the type name of the language provider, including the name of the assembly containing the provider implementation. O nome do tipo deve atender aos requisitos definidos na especificação de nomes de tipo totalmente qualificados.The type name must meet the requirements defined in Specifying Fully Qualified Type Names.
warningLevel Atributo opcional.Optional attribute.

Especifica o nível de aviso do compilador padrão; determina o nível no qual o provedor de idioma trata avisos de compilação como erros.Specifies the default compiler warning level; determines the level at which the language provider treats compilation warnings as errors.

Elementos filhoChild Elements

ElementoElement DescriçãoDescription
<Elemento de > providerOption<providerOption> Element Especifica os atributos de versão do compilador para um provedor de idiomas.Specifies compiler version attributes for a language provider.

Elementos paiParent Elements

ElementoElement DescriçãoDescription
Elemento <configuration><configuration> Element O elemento raiz em cada arquivo de configuração usado pelos aplicativos do Common Language Runtime e .NET Framework.The root element in every configuration file used by the common language runtime and .NET Framework applications.
<Elemento de > System. CodeDom<system.codedom> Element Especifica as definições de configuração do compilador para provedores de linguagem disponíveis.Specifies compiler configuration settings for available language providers.
<compilador > elemento<compilers> Element Contêiner para elementos de configuração do compilador; contém zero ou mais <compiler> elementos.Container for compiler configuration elements; contains zero or more <compiler> elements.

ComentáriosRemarks

Cada <compiler> elemento Especifica os atributos de configuração do compilador para um provedor de idioma específico.Each <compiler> element specifies the compiler configuration attributes for a specific language provider. 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 idiomas.The provider extends the System.CodeDom.Compiler.CodeDomProvider class for a specific language; the <compiler> element defines the compiler and code generator settings for the language provider.

O .NET Framework define as configurações do compilador iniciais no arquivo de configuração do computador (Machine.config).The .NET Framework defines the initial compiler settings in the machine configuration file (Machine.config). Os desenvolvedores e fornecedores do compilador podem adicionar parâmetros de configuração em uma nova implementação do CodeDomProvider.Developers and compiler vendors can add configuration settings for a new CodeDomProvider implementation. Use o método CodeDomProvider.GetAllCompilerInfo para enumerar programaticamente as definições de configuração do compilador e do provedor de linguagem em um computador.Use the CodeDomProvider.GetAllCompilerInfo method to programmatically enumerate language provider and compiler configuration settings on a computer.

Os elementos do compilador no aplicativo ou arquivo de configuração da Web podem complementar ou substituir as configurações no arquivo de configuração da máquina.Compiler elements in the application or Web configuration file can supplement or override the settings in the machine configuration file. 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 de correspondência substituirá quaisquer provedores configurados anteriormente para esse nome de idioma ou extensão de arquivo.If more than one provider implementation is configured for the same language name or the same file extension, the last matching configuration overrides any previous configured providers for that language name or file extension.

Arquivo de ConfiguraçãoConfiguration File

Esse elemento pode ser usado no arquivo de configuração da máquina e no arquivo de configuração do aplicativo.This element can be used in the machine configuration file and the application configuration file.

ExemploExample

O exemplo a seguir ilustra um elemento de configuração de compilador típico:The following example illustrates a typical compiler configuration element:

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

Consulte tambémSee also