Partager via


<compiler> Élément

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

<configuration>
   <system.codedom>
     <Compilateurs>
       <compilateur>

Syntaxe

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

Attributes

Caractéristique Descriptif
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 pour le compilateur.
extension Attribut obligatoire.

Fournit une liste séparée par des points-virgules des extensions de nom de fichier utilisées par les fichiers sources pour le fournisseur de langage. Par exemple, « .cs ».
language Attribut obligatoire.

Fournit une liste séparée par des points-virgules des noms de langue pris en charge par le fournisseur de langues. Par exemple, « c# ; Cs; csharp".
type Attribut obligatoire.

Spécifie le nom de type du fournisseur de langage, y compris le nom de l’assembly contenant l’implémentation du fournisseur. Le nom de type doit répondre aux exigences définies dans la spécification des noms de types complets.
warningLevel Attribut facultatif.

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

Éléments enfants

Élément Descriptif
<providerOption> , élément Spécifie les attributs de version du compilateur pour un fournisseur de langage.

Éléments parents

Élément Descriptif
<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 les paramètres de configuration du compilateur pour les fournisseurs de langage disponibles.
<compilateurs> , élément Conteneur pour les éléments de configuration du compilateur ; contient zéro ou plusieurs <compiler> éléments.

Remarques

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

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

Les éléments du compilateur dans l’application ou le fichier de configuration web peuvent compléter ou remplacer les paramètres dans le fichier de configuration de l’ordinateur. Si plusieurs implémentations de fournisseur sont configurées pour le même nom de langue ou la même extension de fichier, la dernière configuration correspondante remplace tous les fournisseurs configurés précédents pour ce nom de langue ou l’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.

Example

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