<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 |
|---|---|
Élément racine de chaque fichier de configuration utilisé par le Common Language Runtime et les applications .NET Framework. |
|
Spécifie des paramètres de configuration du compilateur pour les fournisseurs de langage disponibles. |
|
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
compiler, élément de compilers pour compilation (Schéma des paramètres ASP.NET)