<providerOption>-Element

Artikel
06/05/2023

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>

Freigeben über