Compartir a través de

Incluir un control de usuario en una página de formularios Web Forms

Los controles de usuario funcionan sólo cuando se incluyen en una página de formularios Web Forms. Cuando llega una solicitud de una página que contiene un control de usuario, este control atraviesa todas las fases de procesamiento a las que está sujeto cualquier control de servidor ASP.NET. Para obtener más información acerca de estas fases de procesamiento, vea Procesamiento de una página de formularios Web Forms.

Incluir un control de usuario en una página de formularios Web Forms es muy simple.

Para incluir un control de usuario en una página de formularios Web Forms

  1. En la página de formularios Web Forms contenedora, declare una directiva @ Register que incluya:

    • Un atributo tagprefix, que asocie un prefijo al control de usuario. Este prefijo se incluirá en la etiqueta de apertura del elemento del control de usuario.

    • Un atributo tagname, que asocie un nombre al control de usuario. Este nombre se incluirá en la etiqueta de apertura del elemento del control de usuario.

    • Un atributo Src, que defina la ruta de acceso virtual al archivo del control de usuario que va a incluir en la página de formularios Web Forms.

      Nota   El valor del atributo Src puede ser una ruta de acceso absoluta o relativa al archivo de código fuente del control de usuario del directorio raíz de la aplicación. Para facilitar su utilización, se recomienda usar una ruta relativa. El carácter tilde (~) representa el directorio raíz de la aplicación.

    Por ejemplo, el código siguiente registra un control de usuario definido en el archivo Login1.ascx. Se le ha asignado el prefijo de etiqueta Acme y el nombre de etiqueta Login. El archivo está ubicado en un directorio Controls.

    <%@ Register TagPrefix="Acme" TagName="Login" Src="~\controls\login1.ascx" %>

  2. Mediante la sintaxis de controles de servidor personalizados, declare el elemento de control de usuario entre las etiquetas de apertura y cierre del control de servidor HtmlForm (<form runat=server></form>). Por ejemplo, para declarar el control importado en el paso anterior, utilice la siguiente sintaxis.

    <html>
<body>
<form runat="server">
<Acme:Login id="MyLogin" runat="server"/>
</form>
</body>
</html>

    Nota   Independientemente del número de controles de servidor ASP.NET (controles de usuario y de cualquier otro tipo) que incluya en la página de formularios Web Forms, sólo debe incluir un control de servidor HtmlForm en dicha página. Incluya todos los controles de servidor entre las etiquetas de apertura y cierre de este control.

Vea también

Controles de usuario de formularios Web Forms | Crear un control de usuario | Control de eventos de servidor en páginas de formularios Web Forms | Controlar eventos de control de usuario

  • Last updated on