<Elemento compiler>

  • Articolo

Specifica gli attributi di configurazione del compilatore per un provider del linguaggio.

<Configurazione>
  <system.codedom>
    <Compilatori>
      <Compilatore>

Sintassi

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

Attributi ed elementi

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.

Attributi

Attributo Descrizione
compilerOptions Attributo facoltativo.

Specifica argomenti aggiuntivi specifici del compilatore per la compilazione. I valori per l'attributo compilerOptions sono in genere elencati in un argomento delle opzioni del compilatore.
extension Attributo obbligatorio.

Fornisce un elenco delimitato da punto e virgola delle estensioni di file usate dai file di origine per il provider di linguaggio. Ad esempio, ".cs".
language Attributo obbligatorio.

Fornisce un elenco delimitato da punto e virgola dei nomi di lingua supportati dal provider di lingue. Ad esempio, "c#; Cs; csharp".
type Attributo obbligatorio.

Specifica il nome del tipo del provider di linguaggio, incluso il nome dell'assembly contenente l'implementazione del provider. Il nome del tipo deve soddisfare i requisiti definiti in Specifica dei nomi di tipi completi.
warningLevel Attributo facoltativo.

Specifica il livello di avviso del compilatore predefinito; determina il livello in cui il provider di linguaggio considera gli avvisi di compilazione come errori.

Elementi figlio

Elemento Descrizione
<Elemento providerOption> Specifica gli attributi della versione del compilatore per un provider di linguaggi.

Elementi padre

Elemento Descrizione
<Elemento configuration> Elemento radice in ciascun file di configurazione usato in Common Language Runtime e nelle applicazioni .NET Framework.
<Elemento system.codedom> Specifica le impostazioni di configurazione del compilatore per i provider di linguaggi disponibili.
<Elemento compilers> Contenitore per gli elementi di configurazione del compilatore; contiene zero o più <compiler> elementi.

Osservazioni:

Ogni <compiler> elemento specifica gli attributi di configurazione del compilatore per un provider di linguaggio specifico. Il provider estende la System.CodeDom.Compiler.CodeDomProvider classe per un linguaggio specifico. L'elemento <compiler> definisce le impostazioni del compilatore e del generatore di codice per il provider di linguaggio.

.NET Framework definisce le impostazioni del compilatore iniziali nel file di configurazione del computer (Machine.config). Gli sviluppatori e i fornitori di compilatori possono aggiungere impostazioni di configurazione per una nuova implementazione di CodeDomProvider. Usare il metodo CodeDomProvider.GetAllCompilerInfo per enumerare a livello di codice le impostazioni di configurazione dei provider di linguaggi e di configurazione del compilatore in un computer.

Gli elementi del compilatore nell'applicazione o nel file di configurazione Web possono integrare o ignorare le impostazioni nel file di configurazione del computer. Se più di un'implementazione del provider è configurata per lo stesso nome di lingua o per la stessa estensione di file, l'ultima configurazione corrispondente sostituisce tutti i provider configurati precedenti per tale nome di lingua o estensione di file.

File di configurazione

Questo elemento può essere usato nel file di configurazione del computer e nel file di configurazione dell'applicazione.

Esempio

L'esempio seguente illustra un tipico elemento di configurazione del compilatore:

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

Vedi anche