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

  • Artículo

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

<controls> 
   <add /> 
</controls>

Atributos y elementos

En las próximas secciones se describen los atributos, los elementos secundarios y los 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 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 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, 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" 
            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

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

ASP.NET Configuration File Hierarchy

Securing Configuration

Otros recursos

Opciones de configuración generales (ASP.NET)

Opciones de configuración de ASP.NET

Configuring ASP.NET Applications

ASP.NET Configuration API