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

[Cette documentation constitue un aperçu et pourra faire l'objet de modifications dans les versions ultérieures. Des rubriques vierges sont incluses en tant qu'espaces réservés.]

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

<buildProviders> 
   <add />
   <clear/>
   <remove />
</buildProviders>

Attributs et éléments

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

Attributs

Aucun

Éléments enfants

Sous-balise

Description

add

Élément facultatif.

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

clear

Élément facultatif.

Supprime toutes les références aux fournisseurs de générations hérités, n'autorisant que les fournisseurs de générations ajoutés par l'élément add actuel.

remove

Élément facultatif.

Supprime de la collection une référence à un fournisseur de générations hérité.

É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 utilisés par ASP.NET pour compiler des applications.

Notes

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 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. Les éléments sont ajoutés à la collection buildProviders dans le fichier Web.config racine.

<buildProviders>
   <clear />
</buildProviders>

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>
            <buildProvider 
               extension=".mafx" 
               type="MyBuildProviderType, MyBuildProviderAssembly" />
         </buildProviders>
      </compilation>
   </system.web>
</configuration>

Informations sur les éléments

Gestionnaire de section de configuration

CompilationSection

Membre de configuration

BuildProviders

BuildProviderCollection

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) 5.0, 5.1 ou 6.0

.NET Framework 2.0

Microsoft Visual Studio 2003 ou Visual Studio 2005

Voir aussi

Tâches

How to: Configure Specific Folders Using Location Settings

How to: Lock ASP.NET Configuration Settings

Référence

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

add, élément de buildProviders pour 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 buildProviders pour compilation (Schéma des paramètres ASP.NET)

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

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

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

expressionBuilders, é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

BuildProviders

BuildProviderCollection

Concepts

ASP.NET Compilation Model

ASP.NET Web Page Syntax Overview

ASP.NET Configuration File Hierarchy

Securing Configuration

Configuration Inheritance

Autres ressources

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

Paramètres de configuration ASP.NET

Configuring ASP.NET Applications

ASP.NET Configuration Files

ASP.NET Configuration API