Compartir a través de


Hacer referencia a un control ASP.NET personalizado

Para trabajar con un control ASP.NET personalizado en una página ASP.NET, se debe hacer referencia al control personalizado en la página, en la página maestra asignada a la página o en un archivo web.config. Resulta útil hacer referencia al control personalizado en un archivo web.config si desea usar el control personalizado en varias páginas del sitio web.

[!NOTA]

Para trabajar con controles ASP.NET personalizados en Microsoft Expression Web, es necesario que el control personalizado esté disponible para Expression Web y agregarlo a la vista Código de la página. Consulte Agregar un control ASP.NET personalizado a un sitio web y Agregar un control ASP.NET personalizado a una página.

Para hacer referencia a un control ASP.NET personalizado en una página ASP.NET

  1. Abra la página en la vista Código o Dividir.

  2. En el panel de códigos, agregue la siguiente línea de código al comienzo de la página:

    <%@ Register assembly="ASSEMBLY_NAME" namespace="ASSEMBLY_NAMESPACE" tagprefix="TAG_PREFIX" %>
    
  3. En la línea de código que ha agregado en el paso anterior, reemplace ASSEMBLY_NAME por el nombre del archivo de ensamblado del control personalizado, excluida la extensión de archivo, ASSEMBLY_NAMESPACE por el valor especificado en la documentación del control personalizado y TAG_PREFIX por cualquier nombre sin espacios.

    [!NOTA]

    Si el control personalizado se instala en la Caché de ensamblados global (GAC) del equipo en lugar de ubicarse en la carpeta Bin del sitio web, reemplace ASSEMBLY_NAMESPACE por el nombre de tipo completo, la versión, el símbolo de clave pública y la referencia cultural del control. Para obtener más información, consulte @Register en MSDN Library.

Para hacer referencia a un control ASP.NET personalizado en un archivo web.config

  1. Abra el archivo web.config del sitio web.

    Si el sitio web no tiene ningún archivo web.config, cree uno y guárdelo en la carpeta raíz del sitio web. Para obtener más información, consulte Crear un archivo de configuración web.

  2. Si el archivo web.config aún no contiene etiquetas <pages> <controls> </pages></controls> , agréguelas después de la etiqueta <system.web> y antes de la etiqueta </system.web>.

  3. Agregue el siguiente código en cualquier lugar después de las etiquetas <system.web><pages><controls> y antes de las etiquetas </system.web></pages></controls>:

    <add tagprefix="TAG_PREFIX" assembly="ASSEMBLY_NAME" namespace="ASSEMBLY_NAMESPACE" />
    
  4. Reemplace ASSEMBLY_NAME por el nombre del archivo de ensamblado del control personalizado, excluida la extensión de archivo, TAG_PREFIX por cualquier nombre sin espacios y ASSEMBLY_NAMESPACE por el valor especificado en la documentación del control personalizado.

    [!NOTA]

    Si el control personalizado se instala en la Caché de ensamblados global (GAC) del equipo en lugar de ubicarse en la carpeta Bin del sitio web, reemplace ASSEMBLY_NAMESPACE por el nombre de tipo completo, la versión, el símbolo de clave pública y la referencia cultural del control. Para obtener más información, consulte @Register en MSDN Library.

Vea también

Conceptos

Introducción a los controles ASP.NET personalizados

Agregar un control ASP.NET personalizado a un sitio web

Agregar un control ASP.NET personalizado a una página