TOC

This article is currently in the process of being translated into Portuguese (~99% done).

The basics:

More events

Certo, o evento 'onclick' do capítulo passado foi fácil, mas vamos tentar criar do zero todo o código requerido para usar um evento. Nós iremos adicionar ainda um novo controle para tornar as coisas mais interessantes - o 'DropDownList', o qual permite o usuário selecionar um item de uma lista. Adicione o seguinte fragmento de código em algum lugar dentro do arquivo Default.aspx.

<asp:DropDownList runat="server" id="GreetList" autopostback="true">
    <asp:ListItem value="no one">No one</asp:ListItem>
    <asp:ListItem value="world">World</asp:ListItem>
    <asp:ListItem value="universe">Universe</asp:ListItem>
</asp:DropDownList>

Este elemento funciona exatamente como se fosse um HTML SELECT element, que é exatamente a tradução que ocorre após a renderização. O único atributo que poderia parecer novo para uma pessoa com experiência básica em HTML é o 'autopostback'. Você irá aprender mais sobre 'postbacks' em um dos próximos capítulos, mas por agora, apenas saiba que faz sentido o controle faça contato com o servidor todas as vezes que um item é selecionado pelo usuário. Nós iremos utilizar isto em nosso benefício agora, introduzindo um evento:

<asp:DropDownList runat="server" id="GreetList" autopostback="true" onselectedindexchanged="GreetList_SelectedIndexChanged">

Nós estamos usando o evento 'onselectedindexchanged' e atribuindo um método do 'CodeBehind' que ainda não existe. Você é livre para escolher o nome do método, entretanto usando a convenção que é: o nome do controle, seguido de underline "_" e então o nome do evento, ajuda a você manter o entendimento de tudo. É melhor a gente ir criar o evento, então mude para o arquivo 'Defautl.aspex.cs' e adicione o seguinte método.

protected void GreetList_SelectedIndexChanged(object sender, EventArgs e)
{
    HelloWorldLabel.Text = "Hello, " + GreetList.SelectedValue;
}

Novamente, nós faremos isto extremamente simples. Nós usamos a propriedade 'SelectedValue' da nossa lista 'dropdown', que contém o texto da propriedade de valor do item selecionado. Tente fazer o site funcionar e selecione um item dentro da lista 'dropdown'. Muito bom, não é? Todos os comandos de controle vem com muitos eventos que são úteis, que você pode subescrever dessa mesma maneira.


This article has been fully translated into the following languages: Is your preferred language not on the list? Click here to help us translate this article into your language!