Elemento add aplicado a 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].

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

Se trata de un elemento nuevo en .NET Framework, versión 2.0.

<add 
   extension="custom resource file extension"
   type="build provider type, build provider assembly" />

Atributos y elementos

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

Atributos

Atributo

Descripción

extension

El atributo String es obligatorio.

Define la extensión de archivo de los recursos personalizados. Este atributo es la clave de la colección.

El valor predeterminado es una cadena vacía ("").

type

El atributo String es obligatorio.

Define el tipo y ensamblado que se van a utilizar para compilar los archivos especificados por el atributo extension.

El valor predeterminado es una cadena vacía ("").

Elementos secundarios

Ninguno.

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 de compilación que utiliza ASP.NET para compilar aplicaciones.

buildProviders

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

Comentarios

El elemento add agrega un proveedor de compilación a la colección contenida en el elemento buildproviders.

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

Add

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

.NET Framework versión 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 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 assemblies 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)

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

System.Configuration

System.Web.Configuration

CompilationSection

Add

Conceptos

ASP.NET Compilation Model

ASP.NET Web Page Code Model

ASP.NET Configuration File Hierarchy

Securing ASP.NET Configuration

ASP.NET Configuration Scenarios

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