Partager via


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

Mise à jour : novembre 2007

Ajoute un fournisseur de générations à la collection.

Cet élément est une nouveauté de la version 2.0 du .NET Framework.

<configuration>, élément
  system.web, élément (Schéma des paramètres ASP.NET)
    compilation, élément (Schéma des paramètres ASP.NET)
      buildProviders, élément de compilation (Schéma des paramètres ASP.NET)
        add, élément de buildProviders pour compilation (Schéma des paramètres ASP.NET)

<add 
   extension="custom resource file extension"
   type="build provider type, build provider assembly"
   Code | Resources | All"
/>

Attributs et éléments

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

Attributs

Attribut

Description

extension

Attribut String requis.

Définit l'extension du fichier de ressources personnalisé. Cet attribut est la clé de collection.

La valeur par défaut est une chaîne vide ("").

type

Attribut String requis.

Définit le type et l'assembly à utiliser pour compiler les fichiers spécifiés par l'attribut extension.

La valeur par défaut est une chaîne vide ("").

Éléments enfants

Aucun.

Éléments parents

Élément

Description

configuration

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

system.web

Spécifie l'élément racine de la section de configuration ASP.NET.

compilation

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

buildProviders

Définit une collection des fournisseurs de générations qui sont utilisés pour compiler des fichiers de ressources personnalisés.

Notes

L'élément add ajoute un fournisseur de générations à la collection contenue dans l'élément buildproviders.

L'élément buildProviders définit une collection de fournisseurs de générations utilisés pour compiler des fichiers de ressources personnalisés d'un type particulier et générer le code pendant la compilation.

Pour définir des actions de génération personnalisées pour un type de fichier dans une application ASP.NET, vous devez dériver une classe de la classe BuildProvider, implémenter des membres dans la classe dérivée pour générer le type de fichier et configurer le fournisseur de générations pour l'extension de fichier correspondante dans le fichier de configuration de l'application. Pour plus d'informations, consultez BuildProvider.

Configuration par défaut

L'élément buildProviders par défaut suivant est configuré dans le fichier Web.config racine.

<buildProviders>
   <add extension=".aspx" type="System.Web.Compilation.PageBuildProvider" />
   <add extension=".ascx" type="System.Web.Compilation.UserControlBuildProvider" />
   <add extension=".master" type="System.Web.Compilation.MasterPageBuildProvider" />
   <add extension=".asix" type="System.Web.Compilation.ImageGeneratorBuildProvider" />
   <add extension=".asmx" type="System.Web.Compilation.WebServiceBuildProvider" />
   <add extension=".ashx" type="System.Web.Compilation.WebHandlerBuildProvider" />
   <add extension=".soap" type="System.Web.Compilation.WebServiceBuildProvider" />
   <add extension=".resx" type="System.Web.Compilation.ResXBuildProvider" />
   <add extension=".resources" type="System.Web.Compilation.ResourcesBuildProvider" />
   <add extension=".wsdl" type="System.Web.Compilation.WsdlBuildProvider" />
   <add extension=".xsd" type="System.Web.Compilation.XsdBuildProvider"/>
   <add extension=".js" type="System.Web.Compilation.ForceCopyBuildProvider" />
</buildProviders>

Exemple

L'exemple de code suivant montre comment définir un fournisseur de générations utilisé pour compiler des fichiers de ressources personnalisés avec l'extension spécifiée.

<configuration>
   <system.web>
      <compilation>
         <buildProviders>
            <add
               extension=".mafx" 
               type="MyBuildProviderType, MyBuildProviderAssembly"/>
         </buildProviders>
      </compilation>
   </system.web>
</configuration>

Informations sur les éléments

Gestionnaire de section de configuration

CompilationSection

Membre de configuration

Add

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

Concepts

Vue d'ensemble de la compilation ASP.NET

Modèle de code 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

Référence

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

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

remove, élément de assemblys pour 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)

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

System.Configuration

System.Web.Configuration

CompilationSection

Add

Autres ressources

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

Paramètres de configuration ASP.NET

Administration de sites Web ASP.NET

Fichiers de configuration ASP.NET

API de configuration ASP.NET