Freigeben über


<compiler> Element

Gibt die Compilerkonfigurationsattribute für einen Sprachanbieter an.

<Konfiguration>
   <system.codedom>
     <Compiler>
       <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

Merkmal Description
compilerOptions Optionales Attribut.

Gibt zusätzliche compilerspezifische Argumente für die Kompilierung an. Die Werte für das Attribut werden in der compilerOptions 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 anforderungen erfüllen, die in der Angabe vollqualifizierter Typnamen definiert sind.
warningLevel Optionales Attribut.

Gibt die Standardmäßige Compilerwarnungsstufe an; bestimmt die Ebene, auf der der Sprachanbieter Kompilierungswarnungen als Fehler behandelt.

Untergeordnete Elemente

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

Übergeordnete Elemente

Element Description
<configuration>-Element Das Stammelement in jeder von den Common Language Runtime- und .NET Framework-Anwendungen verwendeten Konfigurationsdatei.
<system.codedom-Element> Gibt Compilerkonfigurationseinstellungen für verfügbare Sprachanbieter an.
<compilers-Element> Container für Compilerkonfigurationselemente; enthält null oder mehr <compiler> Elemente.

Bemerkungen

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

.NET Framework definiert die anfä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 zum programmgesteuerten Aufzählen von Sprachanbieter- und Compilerkonfigurationseinstellungen auf einem Computer.

Compilerelemente in der Anwendungs- oder Webkonfigurationsdatei können die Einstellungen in der Computerkonfigurationsdatei ergänzen oder überschreiben. Wenn mehrere Anbieterimplementierungen für denselben Sprachnamen oder dieselbe Dateierweiterung konfiguriert sind, setzt die letzte übereinstimmende Konfiguration alle vorherigen konfigurierten Anbieter für diesen Sprachnamen oder die Dateierweiterung außer Kraft.

Konfigurationsdatei

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

Example

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