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

Define una colección de directivas de registro y los espacios de nombres en los que residen los prefijos de etiqueta.

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)

<controls> 
   <add /> 
</controls>

Atributos y elementos

Las siguientes secciones describen atributos, elementos secundarios y elementos primarios.

Atributos

Ninguno.

Elementos secundarios

Elemento Descripción

add

Elemento opcional.

Agrega un prefijo de etiqueta a la colección de prefijos de etiqueta utilizados durante la precompilación.

Elementos primarios

Elemento Descripción

configuration

Especifica el elemento raíz necesario en cada archivo de configuración usado por Common Language Runtime y las aplicaciones .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 globalmente valores de configuración específicos de la página, como directivas ASP.NET para páginas y controles que se encuentran en el ámbito del archivo de configuración.

Comentarios

El elemento controls define una colección de directivas de registro y los espacios de nombres en los que residen los prefijos de etiqueta. Este elemento corresponde a la directiva @ Register en una página ASP.NET. La directiva @ Register permite especificar el prefijo de etiqueta para 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, deberá definir los atributos tagPrefix, tagName y source del elemento secundario add.

  • Si se aplica a un control personalizado, deberá definir los atributos tagPrefix, namespace y assembly del elemento secundario add. El atributo assembly no es necesario si el control se encuentra en el directorio de código de la 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" 
            source="MyControl.ascx"/>
      </controls>
   </pages>

Información de elemento

Controlador de la sección de configuración

PagesSection

Miembro de configuración

Controls

TagPrefixCollection

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

Servicios de Microsoft Internet Information Server (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

Cómo: Configurar directorios concretos mediante la configuración de la ubicación
Cómo: Bloquear los valores de configuración de ASP.NET

Referencia

Elemento pages (Esquema de configuración de ASP.NET)
Elemento add aplicado a controls para pages (Esquema de configuración de ASP.NET)
Elemento tagMapping para pages (Esquema de configuración de ASP.NET)
Elemento namespaces para 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
PagesSection

Conceptos

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

Otros recursos

Opciones de configuración generales (ASP.NET)
Opciones de configuración de ASP.NET
Configurar aplicaciones ASP.NET
API de configuración de ASP.NET