Freigeben über


<compiler>-Element

Gibt die Compilerkonfigurationsattribute für einen Sprachanbieter an.

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

Syntax

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

Attribute und Elemente

In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.

Attribute

Attribut Beschreibung
compilerOptions Optionales Attribut.

Gibt zusätzliche compilerspezifische Argumente für die Kompilierung an. Die Werte für das compilerOptions-Attribut werden in der Regel in einem Compileroptionenthema für den Compiler aufgeführt.
extension Erforderliches Attribut.

Stellt eine durch Semikolons getrennte Liste von Dateinamenerweiterungen bereit, die von Quelldateien für den Sprachanbieter verwendet werden. Beispiel: ".cs".
language Erforderliches Attribut.

Stellt eine durch Semikolons getrennte Liste von Sprachnamen bereit, die vom Sprachanbieter unterstützt werden. Beispiel: "C#;cs;csharp".
type Erforderliches Attribut.

Gibt den Typnamen des Sprachanbieters an, einschließlich des Namens der Assembly, die die Anbieterimplementierung enthält. Der Typname muss die unter Angeben vollqualifizierter Typnamen definierten Anforderungen erfüllen.
warningLevel Optionales Attribut.

Gibt die Standardwarnstufe des Compilers an. Bestimmt die Stufe, ab der der Sprachanbieter Kompilierungswarnungen als Fehler behandelt.

Untergeordnete Elemente

Element BESCHREIBUNG
<providerOption>-Element Gibt die Compilerversionsattribute für einen Sprachanbieter an.

Übergeordnete Elemente

Element BESCHREIBUNG
Element <configuration> Das Stammelement in jeder von den Common Language Runtime- und .NET Framework-Anwendungen verwendeten Konfigurationsdatei.
<system.codedom>-Element Gibt die Compilerkonfigurationseinstellungen für verfügbare Sprachanbieter an.
<compilers>-Element Der Container für Compilerkonfigurationselemente. Enthält 0 (Null) oder mehr <compiler>-Elemente.

Bemerkungen

Jedes <compiler>-Element gibt die Konfigurationsattribute des Compilers für einen bestimmten Sprachanbieter an. Der Anbieter erweitert die System.CodeDom.Compiler.CodeDomProvider-Klasse für eine bestimmte Sprache. Das <compiler>-Element definiert die Einstellungen für den Compiler und den Code-Generator für den Sprachanbieter.

.NET Framework definiert die ursprünglichen Compilereinstellungen in der Computerkonfigurationsdatei (Machine.config). Entwickler und Compileranbieter können Konfigurationseinstellungen für eine neue CodeDomProvider-Implementierung hinzufügen. Verwenden Sie die CodeDomProvider.GetAllCompilerInfo-Methode, um Sprachanbieter und Compilerkonfigurationseinstellungen auf einem Computer programmgesteuert aufzulisten.

Compilerelemente in der Anwendungs- oder Webkonfigurationsdatei können die Einstellungen in der Computerkonfigurationsdatei ergänzen oder außer Kraft setzen. Wenn mehr als eine Anbieterimplementierung für denselben Sprachnamen oder dieselbe Dateierweiterung konfiguriert ist, setzt die letzte übereinstimmende Konfiguration alle zuvor konfigurierten Anbieter für diesen Sprachnamen oder die Dateierweiterung außer Kraft.

Konfigurationsdatei

Dieses Element kann in der Computerkonfigurationsdatei und in der Anwendungskonfigurationsdatei verwendet werden.

Beispiel

Das folgende Beispiel veranschaulicht ein typisches Compilerkonfigurationselement:

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

Siehe auch