<compiler>-Element

Artikel
05/10/2023

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>