<compiler>-Element
Aktualisiert: November 2007
Gibt die Konfigurationsattribute für Compiler für einen Sprachanbieter an.
<configuration>-Element
<system.codedom>-Element
<compilers>-Element
<compiler>-Element
<compiler
language="languageName[;...;...]"
extension="fileExtension[;...;...]"
type="typeName, assemblyName"
warningLevel="number"
compilerOptions="option1 option2"
/>
Attribute und Elemente
In den folgenden Abschnitten werden Attribute und untergeordnete sowie ü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 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 Warnstufe des Compilers an und legt fest, auf welcher Stufe der Sprachanbieter Compilerwarnungen als Fehler behandelt. |
Untergeordnete Elemente
Keines.
Übergeordnete Elemente
Element |
Beschreibung |
|---|---|
Das Stammelement in jeder Konfigurationsdatei, das von der Common Language Runtime und den .NET Framework-Anwendungen verwendet wird. |
|
Gibt die Konfigurationseinstellungen für Compiler für verfügbare Sprachanbieter an. |
|
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
Konzepte
Angeben vollständig gekennzeichneter Typnamen
Referenz
compiler-Element für compilers für compilation (ASP.NET-Einstellungsschema)