<providerOption>, élément

Spécifie les attributs de version du compilateur pour un fournisseur de langages.

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

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Attribut	Description
name	Attribut requis. Spécifie le nom de l'option, par exemple, « CompilerVersion ».
value	Attribut requis. Spécifie la valeur de l'option, par exemple, « 3.5 ».

Éléments enfants

Aucun

Éléments parents

Élément	Description
<configuration>, élément	Élément racine dans chaque fichier de configuration utilisé par le Common Language Runtime et les applications .NET Framework.
<system.codedom>, élément	Spécifie des paramètres de configuration du compilateur pour les fournisseurs de langage disponibles.
<compilers>, élément	Conteneur d'éléments de configuration de compilateur ; contient zéro, un ou plusieurs éléments <compiler>.
<compiler>, élément	Spécifie les attributs de configuration du compilateur pour un fournisseur de langages.

Notes

Dans le .NET Framework version 3.5, les fournisseurs de code CodeDOM (Code Document Object Model) peuvent prendre en charge des options spécifiques au fournisseur grâce à l'élément <providerOption>.

Le .NET Framework 3.5 inclut des assemblys .NET Framework 2.0 mis à jour et fournit des assemblys 3.5 qui contiennent de nouveaux types. Les fournisseurs de code Microsoft C# et Visual Basic sont contenus dans les assemblys .NET Framework 2.0, mais ils ont été mis à jour pour prendre en charge les compilateurs de la version 3.5. Par défaut, les fournisseurs de code mis à jour génèrent le code pour les compilateurs de la version 2.0. Vous pouvez utiliser l'élément <providerOption> pour modifier la version de compilateur cible en 3.5. Pour cela, spécifiez "CompilerVersion" pour l'attribut name et "v3.5" pour l'attribut value. Vous devez faire précéder le numéro de version d'un « v » en minuscule.

Vous pouvez généraliser la spécification de version en ajoutant l'élément <providerOption> au fichier Machine.config ou Web.config racine du .NET Framework 2.0. Si vous mettez à jour la version du compilateur par défaut vers 3.5 dans le fichier Machine.config, vous pouvez revenir à la version 2.0 pour chacune des applications en faisant appel à l'élément <providerOption> dans le fichier de configuration de l'application.

Les implémenteurs de fournisseur de code CodeDOM peuvent traiter des options personnalisées en proposant un constructeur qui accepte un paramètre providerOptions de type IDictionary<TKey, TValue>.

Exemple

L'exemple suivant montre comment spécifier que la version 3.5 du fournisseur de code C# doit être utilisée.

<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>

Voir aussi

Référence

CompilerInfo

CodeDomProvider

<compilers>, élément

compiler, élément de compilers pour compilation (Schéma des paramètres ASP.NET)

Concepts

Spécification des noms de types qualifiés complets

Autres ressources

Schéma des fichiers de configuration pour le .NET Framework