Partager via


<compiler>, élément

Mise à jour : novembre 2007

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

<configuration>, élément
  <system.codedom>, élément
    <compilers>, élément
      <compiler>, élément

<compiler
  language="languageName[;...;...]"
  extension="fileExtension[;...;...]"
  type="typeName, assemblyName"
  warningLevel="number"
  compilerOptions="option1 option2"
/>

Attributs et éléments

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

Attributs

Attribut

Description

compilerOptions

Attribut facultatif.

Spécifie des arguments supplémentaires, spécifiques au compilateur, pour la compilation. Les valeurs de l'attribut compilerOptions sont généralement répertoriées dans une rubrique d'options du compilateur. Dans la documentation Visual Studio 2005, vous pouvez localiser les options du compilateur en recherchant « options du compilateur » dans l'index.

extension

Attribut requis.

Propose une liste séparée par des points-virgules des extensions de nom de fichier utilisées par les fichiers source pour le fournisseur de langage. Par exemple, ".cs".

language

Attribut requis.

Fournit une liste délimitée par des points-virgules de noms de langages pris en charge par le fournisseur de langage. Par exemple, "c#;cs;csharp".

type

Attribut requis.

Spécifie le nom complet du type du fournisseur de langage, en incluant le nom de l'assembly qui contient l'implémentation du fournisseur. Le nom du type doit répondre aux conditions requises définies dans Spécification des noms de types qualifiés complets.

warningLevel

Attribut facultatif.

Spécifie le niveau d'avertissement de compilateur par défaut ; détermine le niveau auquel le fournisseur de langage traite des avertissements de compilation comme des erreurs.

Éléments enfants

Aucun.

Éléments parents

Élément

Description

<configuration>, élément

Élément racine de 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>.

Notes

Chaque élément <compiler> spécifie les attributs de la configuration du compilateur pour un fournisseur de langages spécifique. Le fournisseur étend la classe System.CodeDom.Compiler.CodeDomProvider pour un langage spécifique ; l'élément <compiler> définit les paramètres du compilateur et du générateur de code pour le fournisseur du langage.

Le .NET Framework définit les paramètres de compilateur initiaux du fichier de configuration de l'ordinateur (Machine.config). Les développeurs et fournisseurs de compilateurs peuvent ajouter des paramètres de configuration pour une nouvelle implémentation de CodeDomProvider. Utilisez la méthode CodeDomProvider.GetAllCompilerInfo pour énumérer par programme le fournisseur de langages et les paramètres de configuration du compilateur sur un ordinateur.

Des éléments de compilateur présents dans l'application ou le fichier de configuration Web peuvent remplacer les paramètres du fichier de configuration de l'ordinateur ou s'y ajouter. Si plusieurs implémentations de fournisseur sont configurées pour le même nom de langage ou la même extension de fichier, la dernière configuration correspondante remplace tous les fournisseurs déjà configurés pour ce nom de langage ou cette extension de fichier.

Fichier de configuration

Cet élément peut être utilisé dans le fichier de configuration de l'ordinateur et dans le fichier de configuration de l'application.

Exemple

L'exemple suivant illustre un élément de configuration de compilateur classique :

<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" />
    </compilers>
  </system.codedom>
</configuration>

Voir aussi

Concepts

Spécification des noms de types qualifiés complets

Référence

CompilerInfo

CodeDomProvider

<compilers>, élément

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

Autres ressources

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