Creating a UserControl

Ok, nós estaremos criando um UserControl para mostrar informações sobre um usuário da comunidade. Primeiro de tudo, vamos adicionar um UserControl ao nosso projeto. No seu Visual Studio, você deve ser capaz de clicar com o botão direito no seu projeto e selecionar Adicionar novo item... Uma caixa de dialogo irá surgir, e você deve selecionar Web User Control da lista de possíveis coisas para adicionar. Vamos chamar nosso User Control UseInfoBoxControl, com o nome de arquivo de UserInfoBoxControl.ascx. Tenha certeza que você checou o checkbox que coloca o código em um diferente arquivo, o chamado CodeBehindFile

Agora você deve ter um UserInfoBoxControl.ascx e um UserInfoBoxControl.ascx.cs em seu projeto. O primeiro é onde colocamos nossa marcação e o segundo é o nosso arquivo CodeBehind. Agora, se UserInfoBoxControl.ascx ainda não estiver aberto e selecionado, faça-o agora. Você verá apenas uma linha de código, a declaração UserControl. Como mencionado, esse controle exibirá informações sobre um usuário, então vamos começar a adicionar algumas marcações para fazer isso:

<%@ 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 você pode ver, é tudo muito básico. Nós temos uma declaração, algumas tags padrões, algum texto e depois alguns tipos de variáveis. Agora, de onde elas vem? Bem, agora, elas não vem de lugar algum, desde que nós não declaramos elas ainda. É melhor fazermos isso agora. Abra o arquivo CodeBehind para o UserControl, o que termina com .cs.

Como você pode ver, ele se parece com um arquivo CodeBehind para uma página normal, exceto pelo fato de herdar do UserControl em vez da Page. Declararemos as propriedades de árvore usadas em nossa marcação e as basearemos em três campos correspondentes.

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; }
}

É tudo muito simples e funciona como uma classe regular. Você pode até adicionar métodos, se quiser! Nosso UserControl está pronto agora, mas como você já deve ter experimentado, ainda não podemos usá-lo. Um UserControl não pode ser exibido diretamente no navegador - ele deve ser incluído em uma página. Faremos isso no próximo capítulo.