Compartir a través de

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

  • Artículo

Actualización: noviembre 2007

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.

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

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

Atributos y elementos

Las siguientes secciones describen atributos, elementos secundarios y 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

Atributo String requerido.

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 requerido en cada archivo de configuración usado por Common Language Runtime y las aplicaciones de .NET Framework.

system.web

Especifica el elemento raíz de los valores de configuración ASP.NET en un archivo de configuración y contiene elementos de configuración que configuran las 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 donde 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 de ASP.NET a los ensamblados y espacios de nombres que deben incluirse para que funcionen correctamente los controles COM y controles de usuario. La siguiente información es útil 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.

Se puede usar el mismo valor de tagPrefix para 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 siguiente ejemplo de código se muestra cómo especificar de forma declarativa valores para varios atributos del elemento controls, a los que también se puede obtener 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 directorios virtuales o físicos

Requisitos

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

.NET Framework versión 2.0

Microsoft Visual Studio 2005

Vea también

Tareas

Cómo: Configurar directorios concretos mediante la configuración de la ubicación

Cómo: Bloquear los valores de configuración de ASP.NET

Conceptos

Jerarquía de archivos y herencia de la configuración de ASP.NET

Proteger la configuración de ASP.NET

Referencia

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

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

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

Elemento configuration (Esquema de configuración general)

@ Page

@ Register

System.Configuration

System.Web.Configuration

Controls

TagPrefixCollection

Add

Otros recursos

Opciones de configuración generales (ASP.NET)

Opciones de configuración de ASP.NET

Administrar sitios web ASP.NET

API de configuración de ASP.NET