Compartir a través de

Crear un control de usuario

  • Artículo

Puede crear un control de usuario de forma declarativa utilizando un editor de texto o HTML. La sintaxis declarativa de controles de usuario es muy parecida a la utilizada para crear páginas de formularios Web Forms; la diferencia principal radica en que los controles de usuario no incluyen los elementos <html>, <body> ni <form> en el contenido. Incluya estos elementos en las páginas de formularios Web Forms que contienen el control de usuario. Para obtener más información acerca de las páginas de formularios Web Forms y su modo de creación, vea Introducción a las páginas de formularios Web Forms. Para obtener información sobre cómo declarar un control de usuario en una página de formularios Web Forms, vea Incluir un control de usuario en una página de formularios Web Forms.

Un control de usuario puede ser tan simple como un archivo de texto, o puede contener otros controles de servidor ASP.NET. En el procedimiento siguiente se explica cómo crear un formulario sencillo, que puede incluir en varias páginas de una aplicación.

Nota   Cuando cree una aplicación Web mediante Visual Studio .NET, todas las páginas y controles de usuario de la aplicación deben estar escritas en el mismo lenguaje de programación.

Para crear un control de usuario

  1. Abra un editor de texto o HTML y cree un bloque de declaración de código que exponga las propiedades, los controladores de eventos y cualquier otro código que desee incluir en las funciones del control de usuario.

    Cuando utilice las propiedades de los controles de usuario, tendrá dos opciones. En primer lugar, puede definir nuevas propiedades para el control de usuario y manipularlas. En segundo lugar, puede manipular las propiedades de los controles de servidor que constituyen el control de usuario. Por ejemplo, si declara un control de servidor Web TextBox en un control de usuario y le asigna un ID de MyTextbox, puede manipular su propiedad Text mediante la sintaxis MyTextbox.Text.

    **Nota   **Todas las propiedades y métodos de cualquier control de servidor ASP.NET incluido en un control de usuario se ascienden a propiedades y métodos públicos del control de usuario cuando este control se incluye en una página de formularios Web Forms.

    En el siguiente ejemplo de código se declara un controlador de eventos myButton_Click al que se llama cuando un usuario hace clic en el control de servidor Button creado en el paso 2. Este método obtiene acceso al texto que ha escrito el usuario en un control de servidor Web TextBox y lo muestra en un control de servidor Label.

    <script language="VB" runat="server">
   Public Sub myButton_Click(sender As Object, e As EventArgs)
      output.Text = "Hello, " + name.Text + "."
   End Sub 'myButton_Click 
</script>
[C#]
<script language="C#" runat="server">
   public void myButton_Click(object sender, EventArgs e)
   {
      output.Text = "Hello, " + name.Text + ".";
   }
</script>

  2. Cree los elementos de la interfaz de usuario que debe mostrar el control de usuario. Por ejemplo, el siguiente marcado crea la interfaz de usuario que interactúa con el código del paso 1.

    <table style="background-color:yellow;font: 10pt verdana;border-width:1;border-style:solid;border-color:black;" cellspacing=15>
 <tr>
   <td><b>Enter your name here: </b></td>
   <td><ASP:TextBox id="name" runat="server"/></td>
 </tr>
 <tr>
   <td><b><ASP:Label id="output" runat="server"/></b></td>
 </tr>
 <tr>
   <td></td>
   <td><asp:button id="myButton" text="Submit" OnClick="myButton_Click" runat="server" /></td>
 </tr>
</table>

  3. Asigne un nombre al control de usuario y guárdelo con el nombre de extensión de archivo .ascx. Por ejemplo, puede utilizar para este ejemplo de procedimiento el nombre frmGreet.ascx.

    Nota   Cuando incluya este control de usuario en una página de formularios Web Forms, tendrá que incluir este nombre de archivo y la ruta de acceso del archivo en el atributo Src de la directiva @ Register.

Vea también

Controles de usuario de formularios Web Forms | Incluir un control de usuario en una página de formularios Web Forms | Control de eventos de servidor en páginas de formularios Web Forms