Elemento add aplicado a controls para pages (Esquema de configuración de ASP.NET)

Artículo
05/27/2012

[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 prefijo de etiqueta a la colección de prefijos de etiqueta utilizados durante la precompilación.

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

<add
   assembly="assembly"
   namespace="namespace"
   src="file path"
   tagName="tag name"
   tagPrefix="tag prefix"
>

Atributos y elementos

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

Atributos

Atributo	Descripción
assembly	Atributo String opcional. Especifica el nombre del ensamblado que contiene la implementación de controles COM y requiere que se establezca también el valor del atributo namespace.
namespace	Atributo String opcional. Especifica el espacio de nombres que está asociado al prefijo de etiqueta y requiere que se establezca también el valor del atributoassembly si el control COM no está ubicado en el directorio de código de la aplicación.
src	Atributo String opcional. Especifica el nombre del archivo que contiene el control de usuario y requiere que se establezca también el valor del atributo tagName.
tagName	Atributo String opcional. Especifica el nombre del control que se va a usar en la página y requiere que se establezca también el valor del atributo src.
tagPrefix	El atributo String es obligatorio. Especifica el prefijo de etiqueta que se asigna a un archivo de código fuente o espacio de nombres y un ensamblado. Este atributo requiere una de las siguientes combinaciones de otros atributos: namespace para definir un control COM si el control está en el directorio de código de la aplicación. namespace y assembly para definir un control COM. tagName y src para definir un control de usuario.
Atributos heredados	Atributos opcionales. Atributos heredados por todos los elementos de una sección.

Elementos secundarios

Ninguno.

Elementos primarios

Elemento	Descripción
configuration	Especifica el elemento raíz necesario 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 los valores de configuración de ASP.NET en un archivo de configuración y contiene elementos de configuración que configuran aplicaciones Web ASP.NET y controlan el comportamiento de las aplicaciones.
pages	Define valores de configuración específicos de la página, como directivas ASP.NET globales, para páginas y controles que se encuentran en el ámbito del archivo de configuración.
controls	Define una colección de directivas de registro y los espacios de nombres en los que residen los prefijos de etiqueta.

Comentarios

El elemento add agrega un prefijo de etiqueta a la colección de prefijos de etiqueta en el elemento controls que se utilizan durante la precompilación.

El elemento controls define una colección de directivas de registro y los espacios de nombres donde residen los prefijos de etiqueta. Este elemento corresponde a la directiva @ Register en una página ASP.NET. La directiva @ Register le permite especificar el prefijo de etiqueta de un control de usuario.

Los prefijos de etiqueta asocian un espacio de nombres en ASP.NET a los ensamblados y espacios de nombres que deben incluirse para que los controles COM y de usuario funcionen correctamente. La información siguiente resulta de gran utilidad al configurar el elemento controls:

Si se aplica a un control de usuario, debe definir los atributos tagPrefix, tagName y source del elemento secundario add.
Si se aplica a un control personalizado, debe definir los atributos tagPrefix, namespace y assembly del elemento secundario add. No se requiere el atributo assembly si el control está en el directorio del código de aplicación.

Puede usar el mismo valor de tagPrefix para realizar la asignación a varios ensamblados o espacios de nombres.

Configuración predeterminada

El siguiente elemento controls predeterminado se configura en el archivo Web.config raíz.

<pages>
   <controls>
      <add 
         tagPrefix="asp" 
         namespace="System.Web.UI.WebControls.WebParts" 
         assembly="System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" 
      />
   </controls>
   <!-- Other elements -->
</pages>

Ejemplo

En el ejemplo de código siguiente se muestra cómo especificar valores de manera declarativa para varios atributos del elemento controls, a los que también se puede tener acceso mediante programación como miembros de la clase TagPrefixInfo.

   <pages>
      <controls>
         <!—- Searches all linked assemblies for the namespace -->
         <add 
            tagPrefix="MyTags1" 
            namespace="MyNameSpace"/>
         <!-- Uses a specified assembly -->
         <add 
            tagPrefix="MyTags2"
            namespace="MyNameSpace" 
            assembly="MyAssembly"/>
         <!-- Uses the specified source for the user control -->
         <add 
            tagprefix="MyTags3" 
            tagname="MyCtrl" 
            src="controls/MyControl.ascx"/>
      </controls>
   </pages>

Información de elemento

Controlador de la sección de configuración	PagesSection
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 2005

Vea también

Elemento add aplicado a controls para pages (Esquema de configuración de ASP.NET)

Atributos y elementos

Atributos

Elementos secundarios

Elementos primarios

Comentarios

Configuración predeterminada

Ejemplo

Información de elemento

Vea también

Tareas

Referencia

Conceptos

Otros recursos

Recursos adicionales