<providerOption>, élément

Article
05/10/2023

Spécifie les attributs de configuration de compilateur pour un fournisseur de langage.

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

Syntaxe

<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, « v3.5 ».

Éléments enfants

Aucune.

Éléments parents

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

Notes

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

.NET Framework 3.5 comprend des assemblys .NET Framework 2.0 mis à jour et fournit de nouveaux assemblys de version 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 ont été mis à jour pour prendre en charge les compilateurs de version 3.5. Par défaut, les fournisseurs de code mis à jour génèrent du code pour les compilateurs de version 2.0. Vous pouvez utiliser l’élément <providerOption> pour passer à la version de compilateur cible 3.5. Pour ce faire, 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 » minuscule.

Vous pouvez globaliser la spécification de version en ajoutant l’élément <providerOption> au fichier Web.config racine ou Machine.config de .NET Framework 2.0. Si vous mettez à jour la version de compilateur par défaut vers 3.5 dans le fichier Machine.config, vous pouvez la faire repasser à 2.0 par application en utilisant l’élément <providerOption> dans le fichier de configuration d’application.

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

Exemple

L’exemple suivant montre comment préciser 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>

Share via