Elemento buildProviders para compilation (Esquema de configuración de ASP.NET)

[Esta documentación se proporciona solo para fines preliminares y está sujeta a cambios en versiones posteriores. Se incluye temas en blanco como marcadores].

Define una colección de proveedores de compilación que se utilizan para compilar archivos de recursos personalizados.

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

Atributos y elementos

En las próximas secciones se describen los atributos, los elementos secundarios y los elementos primarios.

Atributos

Ninguno.

Elementos secundarios

Subetiqueta

Descripción

add

Elemento opcional.

Agrega un proveedor de compilación a la colección.

clear

Elemento opcional.

Quita todas las referencias a proveedores de compilación heredados y permite sólo los proveedores de compilación agregados por el elemento add actual.

remove

Elemento opcional.

Quita una referencia a un proveedor de compilación heredado de la colección.

Elementos primarios

Elemento

Descripción

configuration

Especifica el elemento raíz de cada archivo de configuración que utilizan las aplicaciones basadas en Common Language Runtime y .NET Framework.

system.web

Especifica el elemento raíz de la sección de configuración de ASP.NET.

compilation

Configura todas las opciones que utiliza ASP.NET para compilar aplicaciones.

Comentarios

El elemento buildProviders define una colección de proveedores de compilación que se utilizan para compilar archivos de recursos personalizados de un tipo de archivo determinado y para generar código durante la compilación.

Si desea definir acciones de compilación personalizadas para un tipo de archivo en una aplicación ASP.NET, deberá derivar una clase de la clase BuildProvider, implementar miembros de la clase derivada para compilar el tipo de archivo y configurar el proveedor de compilación para la extensión de archivo que corresponda dentro del archivo de configuración de la aplicación. Para obtener más información, vea BuildProvider.

Configuración predeterminada

El elemento predeterminado siguiente buildProviders no se configura explícitamente en el archivo Machine.config ni en el archivo Web.config raíz. Sin embargo, es la configuración predeterminada que devuelve la aplicación. Los elementos se agregan a la colección buildProviders en el archivo Web.config raíz.

<buildProviders>
   <clear />
</buildProviders>

El elemento buildProviders predeterminado se configura en el archivo Web.config de la raíz.

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

Ejemplo

En el siguiente ejemplo de código se muestra cómo definir un proveedor de compilación usado para compilar archivos de recursos personalizados con la extensión especificada.

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

Información de elemento

Controlador de la sección de configuración

CompilationSection

Miembro de configuración

BuildProviders

BuildProviderCollection

Ubicaciones configurables

Machine.config

Web.config del nivel raíz

Web.config del nivel de aplicaciones

Web.config del nivel de directorio virtual o físico

Requisitos

Microsoft Internet Information Services (IIS) versión 5.0, 5.1 o 6.0

.NET Framework 2.0

Microsoft Visual Studio 2003 o Visual Studio 2005

Vea también

Tareas

How to: Configure Specific Folders Using Location Settings

How to: Lock ASP.NET Configuration Settings

Referencia

Elemento compilation (Esquema de configuración de ASP.NET)

Elemento add aplicado a buildProviders para compilation (Esquema de configuración de ASP.NET)

Elemento clear aplicado a buildProviders para compilation (Esquema de configuración de ASP.NET)

Elemento remove aplicado a buildProviders para compilation (Esquema de configuración de ASP.NET)

Elemento assemblies para compilation (Esquema de configuración de ASP.NET)

Elemento codeSubDirectories para compilation (Esquema de configuración de ASP.NET)

Elemento compilers para compilation (Esquema de configuración de ASP.NET)

Elemento expressionBuilders para compilation (Esquema de configuración de ASP.NET)

Elemento configuration (Esquema de configuración general)

Elemento system.web (Esquema de configuración de ASP.NET)

System.Configuration

System.Web.Configuration

CompilationSection

BuildProviders

BuildProviderCollection

Conceptos

ASP.NET Compilation Model

ASP.NET Web Page Syntax Overview

ASP.NET Configuration File Hierarchy

Securing Configuration

Configuration Inheritance

Otros recursos

Opciones de configuración generales (ASP.NET)

Opciones de configuración de ASP.NET

Configuring ASP.NET Applications

ASP.NET Configuration Files

ASP.NET Configuration API