Cómo: Incluir un control de usuario en una página Web ASP.NET

  • Artículo

Actualización: noviembre 2007

Para utilizar un control de usuario, éste debe incluirse en una página Web ASP.NET. Cuando se recibe una solicitud de una página y ésta contiene un control de usuario, dicho control pasa por todas las fases de procesamiento que realizan los controles de servidor ASP.NET. Para obtener más información sobre estas fases de procesamiento, vea Información general sobre el ciclo de vida de una página ASP.NET.

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

  1. En la página Web ASP.NET contenedora, cree una directiva @ Register que incluya lo siguiente:

    • Un atributo TagPrefix, que permite asociar 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 permite asociar 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 permite definir la ruta de acceso virtual al archivo del control de usuario que se va a incluir.

      Nota:

      El valor del atributo Src puede ser una ruta de acceso relativa o absoluta al archivo de código fuente del control de usuario partiendo del directorio raíz de la aplicación. Para mayor flexibilidad, se recomienda utilizar una ruta de acceso relativa. El carácter tilde (~) representa el directorio raíz de la aplicación. Los controles de usuario no pueden situarse en el directorio App_Code.

  2. En el cuerpo de la página Web, declare el elemento de control de usuario dentro del elemento form.

  3. Si el control de usuario expone propiedades públicas, también puede establecerlas mediante declaración.

Ejemplo

En el ejemplo siguiente se muestra una página Web ASP.NET que contiene un control de usuario. Éste se encuentra en el archivo Spinner.ascx de la carpeta Controls. En la página, el control se registra para que utilice el prefijo uc y el nombre de etiqueta Spinner. Las propiedades MinValue y MaxValue del control de usuario se establecen mediante declaración.

Nota:

Para obtener más información sobre el código del control de usuario empleado en este ejemplo, vea Cómo: Crear controles de usuario ASP.NET.

 
<%@ Page Language="VB" %>
<%@ Register TagPrefix="uc" TagName="Spinner" 
    Src="~\Controls\Spinner.ascx" %>
<html>
<body>
<form >
    <uc:Spinner id="Spinner1" 
         
        MinValue="1" 
        MaxValue="10" />
</form>
</body>

<%@ Page Language="C#" %>
<%@ Register TagPrefix="uc" TagName="Spinner" 
    Src="~\Controls\Spinner.ascx" %>
<html>
<body>
<form >
    <uc:Spinner id="Spinner1" 
         
        MinValue="1" 
        MaxValue="10" />
</form>
</body>

Vea también

Conceptos

Información general sobre los controles de usuario ASP.NET

Crear una guía básica de controles ASP.NET personalizados