Teilen über


<providerOption> Element

Gibt die Compilerversionsattribute für einen Sprachanbieter an.

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

Merkmal Description
name Erforderliches Attribut.

Gibt den Namen der Option an; Beispiel: "CompilerVersion".
value Erforderliches Attribut.

Gibt den Wert für die Option an; Beispiel: "v3.5".

Untergeordnete Elemente

Keiner.

Übergeordnete Elemente

Element Description
<configuration>-Element Das Stammelement in jeder Konfigurationsdatei, die von der Common Language Runtime und .NET Framework-Anwendungen verwendet wird.
<system.codedom-Element> Gibt Compilerkonfigurationseinstellungen für verfügbare Sprachanbieter an.
<compilers-Element> Container für Compilerkonfigurationselemente; enthält 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 (CodeDOM)-Codeanbieter anbieterspezifische Optionen mithilfe des <providerOption> Elements unterstützen.

.NET Framework 3.5 enthält aktualisierte .NET Framework 2.0-Assemblys und stellt neue Assemblys der Version 3.5 bereit, die neue Typen enthalten. 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 Zielcompilerversion in 3.5 zu ändern. Geben Sie dazu "CompilerVersion" für das name Attribut und "v3.5" für das value Attribut an. Sie müssen der Versionsnummer ein Kleinbuchstabe "v" vorangehen.

Sie können die Versionsspezifikation global festlegen, indem Sie das <providerOption> Element zur .NET Framework 2.0-Machine.config- oder Stammdatei Web.config Hinzufügen. Wenn Sie die Standardcompilerversion in der datei Machine.config auf 3.5 aktualisieren, können Sie sie mithilfe des <providerOption> Elements in der Anwendungskonfigurationsdatei auf 2.0-Basis auf 2.0 zurücksetzen.

CodeDOM-Codeanbieterimplementierer können benutzerdefinierte Optionen verarbeiten, indem ein Konstruktor bereitgestellt wird, der einen providerOptions Parameter vom Typ IDictionary<TKey,TValue>verwendet.

Example

Im folgenden Beispiel wird veranschaulicht, wie Sie angeben, 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