Partager via

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

  • Article

Définit une nouvelle option de compilateur. La section compiler peut accueillir n'importe quel nombre de balises compiler.

RemarqueRemarque

Dans le .NET Framework version 2.0, cet élément est déconseillé en faveur de l'élément compiler de la section system.codeDom.Toutefois, l'utilisation de l'élément enfant compilers de l'élément compilation est encore valide et substitue l'élément compilers situé dans la section system.codedom.

 
<compiler 
   language="language"
   extension="ext"
   type=".NET Type" 
   warningLevel="number"  
   compilerOptions="options"
/>

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.

Répertorie des options supplémentaires spécifiques au compilateur à passer pendant la compilation.

extension

Attribut facultatif.

Propose une liste, séparée par des points-virgules, des extensions de nom de fichier utilisées pour les fichiers code-behind dynamiques. Par exemple, ".cs".

language

Attribut facultatif.

Fournit une liste, délimitée par des points-virgules, des langages utilisés dans les fichiers de compilation dynamiques. Par exemple, "c#;cs;csharp".

type

Attribut requis.

Spécifie une combinaison classe/assembly séparée par des virgules qui indique la classe .NET Framework (qui étend la classe CodeDomProvider) employée pour compiler toutes les ressources utilisant l'extension de nom de fichier ou le langage spécifié.

warningLevel

Attribut facultatif.

Spécifie les niveaux d'avertissement du compilateur.

Éléments enfants

Aucun

Éléments parents

Élément

Description

configuration

Spécifie l'élément racine requis dans chaque fichier de configuration utilisé par le Common Language Runtime et les applications .NET Framework.

system.web

Spécifie l'élément racine des paramètres de configuration ASP.NET dans un fichier de configuration et contient des éléments de configuration qui configurent des applications Web ASP.NET et contrôlent le comportement des applications.

compilation

Configure tous les paramètres de compilation qu'ASP.NET utilise pour compiler des applications.

compilers

Spécifie les compilateurs pris en charge par l'application ASP.NET.

RemarqueRemarque
Dans le .NET Framework version 2.0, cet élément est déconseillé en faveur de l'élément compilers de la section system.codeDom.Toutefois, l'utilisation de l'élément enfant compilers de l'élément compilation est encore valide et substitue l'élément compilers situé dans la section system.codedom.

Notes

L'élément compiler définit une nouvelle option de compilateur. Vous pouvez utiliser le nombre de balises compiler de votre choix dans la section compiler.

Dans le .NET Framework version 2.0, cet élément est déconseillé en faveur de l'élément compiler de la section system.codeDom. Toutefois, l'utilisation de l'élément enfant compilers de l'élément compilation est encore valide et substitue l'élément compilers situé dans la section system.codedom.

Configuration par défaut

Par défaut, l'élément compilers n'est pas configuré dans le .NET Framework version 2.0 parce que cet élément a été déconseillé. Toutefois, un élément compilers par défaut est défini dans la section system.codeDom.

L'élément par défaut n'est pas configuré explicitement dans le fichier Machine.config ou dans le fichier Web.config racine. Toutefois, il s'agit de la configuration par défaut retournée par l'application.

<system.codedom>
   <compilers>
       <compiler language="c#;cs;csharp" extension=".cs" type="Microsoft.CSharp.CSharpCodeProvider, System, Version=%ASSEMBLY_VERSION%, Culture=neutral, PublicKeyToken=%ECMA_PUBLICKEY%" warningLevel="1" />
       <compiler language="vb;vbs;visualbasic;vbscript" extension=".vb" type="Microsoft.VisualBasic.VBCodeProvider, System, Version=%ASSEMBLY_VERSION%, Culture=neutral, PublicKeyToken=%ECMA_PUBLICKEY%" />
       <compiler language="js;jscript;javascript" extension=".js" type="Microsoft.JScript.JScriptCodeProvider, Microsoft.JScript, Version=8.0.1100.0, Culture=neutral, PublicKeyToken=%MICROSOFT_PUBLICKEY%" />
       <compiler language="vj#;vjs;vjsharp" extension=".jsl" type="Microsoft.VJSharp.VJSharpCodeProvider, VJSharpCodeProvider, Version=%ASSEMBLY_VERSION%, Culture=neutral, PublicKeyToken=%MICROSOFT_PUBLICKEY%" />
       <compiler language="c++;mc;cpp" extension=".h" type="Microsoft.VisualC.CppCodeProvider, CppCodeProvider, Version=8.0.0.0, Culture=neutral, PublicKeyToken=%MICROSOFT_PUBLICKEY%" />
   </compilers>
</system.codedom>

L'élément compilers par défaut est configuré dans le fichier Machine.config de la version 1.1 du .NET Framework.

<compilers>
   <compiler language="c#;cs;csharp" extension=".cs" type="Microsoft.CSharp.CSharpCodeProvider, System, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" warningLevel="1"/>
   <compiler language="vb;vbs;visualbasic;vbscript" extension=".vb" type="Microsoft.VisualBasic.VBCodeProvider, System, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"/>
   <compiler language="js;jscript;javascript" extension=".js" type="Microsoft.JScript.JScriptCodeProvider, Microsoft.JScript, Version=7.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"/>
   <compiler language="VJ#;VJS;VJSharp" extension=".jsl" type="Microsoft.VJSharp.VJSharpCodeProvider, VJSharpCodeProvider, Version=7.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"/>
</compilers>

L'élément compilers par défaut est configuré dans le fichier Machine.config de la version 1.0 du .NET Framework.

<compilers>
    <compiler language="c#;cs;csharp" extension=".cs" type="Microsoft.CSharp.CSharpCodeProvider, System, Version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" warningLevel="1" />
    <compiler language="vb;vbs;visualbasic;vbscript" extension=".vb" type="Microsoft.VisualBasic.VBCodeProvider, System, Version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
    <compiler language="js;jscript;javascript" extension=".js" type="Microsoft.JScript.JScriptCodeProvider, Microsoft.JScript, Version=7.0.3300.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
</compilers>

Exemple

L'exemple de code suivant montre comment configurer des paramètres de compilation pour une application.

<configuration>
   <system.web>
      <compilation defaultLanguage="VB"
         debug="true"
         numRecompilesBeforeAppRestart="15">
         <compilers>
            <compiler language="VB;VBScript"
               extension=".cls"
               type="Microsoft.VisualBasic.VBCodeProvider,system,     
                     Version=1.0.5000.0, Culture=neutral, 
                     PublicKeyToken=b77a5c561934e089"/>
            <compiler language="C#;Csharp"
               extension=".cs" 
               type="Microsoft.CSharp.CSharpCodeProvider,system, 
                     Version=1.0.5000.0,  Culture=neutral, 
                     PublicKeyToken=b77a5c561934e089"/>
         </compilers>
      </compilation>
   </system.web>
</configuration>

Informations sur les éléments

Gestionnaire de section de configuration

CompilationSection

Membre de configuration

Compilers

Compiler

Emplacements configurables

Machine.config

Web.config racine

Web.config au niveau de l'application

Web.config de niveau répertoire virtuel ou physique

Configuration requise

Microsoft Internet Information Services (IIS) version 5.0, 5.1 ou 6.0

.NET Framework version 1.0, 1.1 ou 2.0

Microsoft Visual Studio 2003 ou Visual Studio 2005

Voir aussi

Tâches

Comment : configurer des répertoires spécifiques à l'aide des paramètres d'emplacement

Comment : verrouiller des paramètres de configuration ASP.NET

Référence

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

configuration, élément (Schéma des paramètres généraux)

system.web, élément (Schéma des paramètres ASP.NET)

System.Configuration

System.Web.Configuration

CompilationSection

Compilers

CompilerCollection

Concepts

Vue d'ensemble de la compilation ASP.NET

Vue d'ensemble de la syntaxe des pages Web ASP.NET

Hiérarchie du fichier de configuration ASP.NET et héritage

Sécurisation de la configuration ASP.NET

Scénarios de configuration ASP.NET

Autres ressources

Paramètres généraux de configuration (ASP.NET)

Paramètres de configuration ASP.NET

Administration de site Web ASP.NET

Fichiers de configuration ASP.NET

API de configuration ASP.NET