<compiler>-Element

Gibt die Konfigurationsattribute für Compiler für einen Sprachanbieter an.

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

Attribute und Elemente

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

Attribute

Attribute

Beschreibungen

compilerOptions

Optionales Attribut.

Gibt zusätzliche compilerspezifische Argumente für die Kompilierung an. Die Werte für das compilerOptions-Attribut werden normalerweise in einem Compileroptionen-Thema für den Compiler aufgelistet. Sie finden die Optionen für den Compiler in der Dokumentation zu Visual Studio 2005, indem Sie im Index nach "Compileroptionen" suchen.

extension

Erforderliches Attribut.

Gibt eine durch Semikolons getrennte Liste der für Quelldateien des Sprachanbieters verwendeten Datenamenerweiterungen an. Beispiel: ".cs".

language

Erforderliches Attribut.

Gibt eine durch Semikolons getrennte Liste mit vom Sprachanbieter unterstützten Sprachnamen an. Beispiel: "c#;cs;csharp".

type

Erforderliches Attribut.

Gibt den Typnamen des Sprachanbieters und den Namen der Assembly an, die die Anbieterimplementierung enthält. Der Typname muss den unter Angeben vollständig gekennzeichneter Typnamen definierten Anforderungen entsprechen.

warningLevel

Optionales Attribut.

Gibt die standardmäßige Compilerwarnungsebene an. Bestimmt die Ebene, ab der der Sprachanbieter Compilerwarnungen als Fehler behandelt.

Untergeordnete Elemente

Element

Beschreibungen

<providerOption>-Element

Gibt Versionsattribute für Compiler für einen Sprachanbieter an.

Übergeordnete Elemente

Element

Beschreibungen

<configuration>-Element

Das Stammelement in jeder von den Common Language Runtime- und .NET Framework-Anwendungen verwendeten Konfigurationsdatei.

<system.codedom>-Element

Gibt die Konfigurationseinstellungen für Compiler für verfügbare Sprachanbieter an.

<compilers>-Element

Container für die Konfigurationselemente für Compiler. Enthält keine oder mehrere <compiler>-Elemente.

Hinweise

Jedes <compiler>-Element gibt Konfigurationsattribute für Compiler 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 Compiler und Codegenerator für den Sprachanbieter.

In .NET Framework werden die ursprünglichen Compilereinstellungen in der Computerkonfigurationsdatei (machine.config) definiert. Entwickler und Compileranbieter können Konfigurationseinstellungen für eine neue CodeDomProvider-Implementierung hinzufügen. Verwenden Sie die CodeDomProvider.GetAllCompilerInfo-Methode für die programmgesteuerte Auflistung der Konfigurationseinstellungen für Sprachanbieter und Compiler auf einem Computer.

Compilerelemente in der Anwendungs- oder Webkonfigurationsdatei können die Einstellungen in der Computerkonfigurationsdatei ergänzen oder überschreiben. Bei der Konfiguration mehrerer Anbieterimplementierungen für denselben Sprachnamen oder dieselbe Dateierweiterung überschreibt die letzte übereinstimmende Konfiguration alle vorherigen konfigurierten Anbieter für den Sprachnamen oder die Dateierweiterung.

Konfigurationsdatei

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

Beispiel

Im folgenden Beispiel wird ein typisches Konfigurationselement für Compiler dargestellt.

<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

Referenz

CompilerInfo

CodeDomProvider

<compilers>-Element

compiler-Element für compilers für compilation (ASP.NET-Einstellungsschema)

Konzepte

Angeben vollständig gekennzeichneter Typnamen

Weitere Ressourcen

Konfigurationsdateischema für .NET Framework