Creando un UserControl

De acuerdo, entonces vamos a construir un control de usuario que expondrá información acerca de un usuario comunitario. Primero que todo agreguemos un control de usuario a nuestro proyecto en el Visual Studio, hacemos un click derecho sobre nuestro proyecto y seleccionamos "Add new item". Aparecerá una ventana de dialogo con una lista de las opciones posibles de agregar. Llamemos a nuestro Control de Usuario UserInfoBoxControl, con el nombre de archivo UserInfoBoxControl.ascx. Aseguremonos de haber marcado la casilla que pone el código en otro archivo, el llamado archivo "CodeBehind.

Ahora deberías tener los archivos UserInfoBoxControl.ascx y UserInfoBoxControl.ascx en tu proyecto. El primer es donde agregamos nuestro marcado y el segundo es nuestro archivo CodeBehind. Ahora, si UserInfoBoxControl.ascx no se encuentra abierta y seleccionada, hazlo. Verás solamente una línea de código, la declaración de UserControl. Como se mencionó, el control mostrará información acerca del usuario, así que comencemos a agregar etiquetas para hacerlo.

<%@ Control Language="C#" AutoEventWireup="true" CodeFile="UserInfoBoxControl.ascx.cs" Inherits="UserInfoBoxControl" %>
<b>Information about <%= this.UserName %></b>
<br /><br />
<%= this.UserName %> is <%= this.UserAge %> years old and lives in <%= this.UserCountry %>

Como puedes ver, es todo muy sencillo. Tenemos una declaración, algunas etiquetas estándar, algo de texto y después tenemos un tipo de variables Ahora, ¿de donde vienen? Bueno, ahora mismo, no vienen de ninguna parte, ya que aún no las hemos declarado. Mejor comencemos a hacerlo. Abre el archivo CodeBehind del UserControl, o sea, el que termina en .cs.

Como podrás notar, luce como un archivo de CodeBehind para una página común, excepto que hereda de UserControl y no de Page. Declararemos las tres propiedades utilizadas en nuestras etiquetas, y las basaremos en nuestros tres campos correspondientes.

private string userName;
private int userAge;
private string userCountry;

public string UserName
{
    get { return userName; }
    set { userName = value; }
}

public int UserAge
{
    get { return userAge; }
    set { userAge = value; }
}

public string UserCountry
{
    get { return userCountry; }
    set { userCountry = value; }
}

Es todo muy sencillo y funciona como una clase común. Incluso puedes agregar métodos si te apetece. Nuestro UserControl está ahora completo, pero como podrás haber experimentado, aún no podemos utilizarlo. Un UserControl no puede ser mostrado directamente en el navegador - debe ser incluido en una página. Esto lo haremos en el siguiente capítulo.