<providerOption>-Element

  • Artikel

Gibt die Compilerversionsattribute für einen Sprachanbieter an.

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

Syntax

<providerOption  
  name="option-name"  
  value="option-value"  
/>

Attribute und Elemente

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

Attribute

Attribut Beschreibung
name Erforderliches Attribut.

Gibt den Namen der Option an, z. B. „CompilerVersion“.
value Erforderliches Attribut.

Gibt den Wert der Option an, z. B. „v3.5“.

Untergeordnete Elemente

Keine

Übergeordnete Elemente

Element BESCHREIBUNG
<configuration>-Element Das Stammelement in jeder Konfigurationsdatei, die von der Common Language Runtime und den .NET Framework-Anwendungen verwendet wird.
<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.
<compiler>-Element Gibt die Compilerkonfigurationsattribute für einen Sprachanbieter an.

Bemerkungen

In .NET Framework Version 3.5 können Code Document Object Model-Codeanbieter (CodeDOM) anbieterspezifische Optionen mithilfe des <providerOption>-Elements unterstützen.

Das .NET Framework 3.5 enthält neben aktualisierten .NET Framework 2.0-Assemblys auch neue Assemblys der Version 3.5 mit neuen Typen. Die Microsoft C#- und Visual Basic-Codeanbieter sind in .NET Framework 2.0-Assemblys enthalten, wurden jedoch aktualisiert, um Compiler der Version 3.5 zu unterstützen. Standardmäßig generieren die aktualisierten Codeanbieter Code für Compiler der Version 2.0. Sie können das <providerOption>-Element verwenden, um die Zielversion des Compilers in 3.5 zu ändern. Geben Sie hierzu „CompilerVersion“ für das name-Attribut und „v3.5“ für das value-Attribut an. Die Versionsnummer muss mit dem Kleinbuchstaben „v“ beginnen.

Sie können die Versionsangabe global festlegen, indem Sie das <providerOption>-Element der Datei „.NET Framework 2.0-Machine.config“ oder der Stammdatei „Web.config“ hinzufügen. Wenn Sie die Standardcompilerversion in der Datei „Machine.config“ auf 3.5 aktualisieren, können Sie sie auf Anwendungsbasis wieder in 2.0 ändern, indem Sie das <providerOption>-Element in der Anwendungskonfigurationsdatei verwenden.

In Implementierungen von CodeDOM-Codeanbietern können benutzerdefinierte Optionen verarbeitet werden, indem ein Konstruktor bereitgestellt wird, der einen providerOptions-Parameter vom Typ IDictionary<TKey,TValue>verwendet.

Beispiel

Im folgenden Beispiel wird veranschaulicht, wie Sie angeben können, dass Version 3.5 des C#-Codeanbieters verwendet werden soll.

<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" >  
          <providerOption  
            name="CompilerVersion"  
            value="v3.5" />  
      </compiler>  
    </compilers>  
  </system.codedom>  
</configuration>

Siehe auch