Conheça o Júlio Battisti

Julio Battisti - Autor de mais de 25 livros de informática Júlio Battisti tem mais de 50 livros publicados, centenas de e-books e é certificado Microsoft.

SAIBA MAIS...

Loja Virtual do Site

Curta Nossa Fanpage

« Lição anterior

Δ Página principal

¤ Capítulos

Próxima lição »

ASP.NET - CURSO COMPLETO
Autor: Júlio Battisti

Lição 073 - Capítulo 09 - ListBox Web Server Control

Este controle é utilizado para criar uma lista de seleção, onde podemos selecionar um ou mais elementos. Para definir o número de elementos que são exibidos, simultaneamente, devemos definir a propriedade Rows. Por padrão é exibido uma lista de uma única linha. Para habilitar a seleção de múltiplos elementos da lista, devemos definir a propriedade SelectionMode=”Multiple”.

NOTA: O Controle ListBox Web Server Control é derivado da classe base ListBox, do namespace System.Web.UI.WebControls. Para uma referência completa à todas as propriedades e métodos deste controle, consulte a documentação do Framework .NET.

Para adicionar elementos a lista de elementos do controle ListBox, utilizamos o controle ListItem, conforme veremos no exemplo mais adiante.

A sintaxe para este controle é a seguinte:

<asp:ListBox

     id="Identificação_no_código"

     DataSource="<% Expressão para  conexão com uma fonte de dados %>"

     DataTextField="Nome do campo"

     DataValueField="Valor do campo"

     AutoPostBack="True|False"

     Rows="Número de linhas do  controle"

     SelectionMode="Single|Multiple"

     OnSelectedIndexChanged="Método que  será executado em resposta ao evento."

     runat="server">

   <asp:ListItem value="value"  selected="True|False">

            Texto do item.

    </asp:ListItem>

</asp:ListBox>

Vamos apresentar um exemplo de utilização do controle ListBox. O nosso exemplo é constituído de um formulário no qual colocamos um controle ListBox, com seis elementos. O controle permite seleções múltiplas e seu tamanho é definido em 4 linhas. Ao clicar no botão Enviar, o evento Click deste botão informa qual foi o primeiro elemento a ser selecionado.

Na Listagem 9.4 temos o código para o exemplo proposto.

Listagem 9.4 – O controle ListBox – chap9ex4.aspx.

<html>

<head>

    <script language="C#" runat="server">

       void Enviar_Click(Object sender, EventArgs e)

          if (ListBox1.SelectedIndex > -1)

            Label1.Text=" O primeiro item  que você selecionou foi: " +

ListBox1.SelectedItem.Text;

    </script>

</head>

<body>

<form runat=server>

      <h3><font  face="Verdana">Exemplo do controle  ListBox!!</font></h3>

      <asp:ListBox  id="ListBox1"

            Rows="4"

            SelectionMode="Multiple"

            Width="100px"

            runat="server"

            style="color:White;

            background-color:Black;"

             <asp:ListItem>Item  1</asp:ListItem>

             <asp:ListItem>Item 2</asp:ListItem>

             <asp:ListItem>Item  3</asp:ListItem>

             <asp:ListItem>Item  4</asp:ListItem>

             <asp:ListItem>Item  5</asp:ListItem>

             <asp:ListItem>Item  6</asp:ListItem>

      </asp:ListBox>

       <asp:button id="Enviar"

            Text="Enviar"

            OnClick="Enviar_Click"

            runat="server" />

<p>

       <asp:Label id="Label1"

            Font-Name="Verdana"

            Font-Size="10pt"

            runat="server"/>

</form>

</body>

</html>

Digite o código da Listagem 9.4 e salve o mesmo em um arquivo chamado chap9ex4.aspx, na pasta chap9, dentro da pasta wwwroot, conforme descrito no item: “Check List para acompanhar os exemplos deste livro”, no Capítulo 6.

Para acessar esta página utilize o seguinte endereço:

http://localhost/chap9/chap9ex4.aspx

Para selecionar múltiplas opções na lista de opções, mantenha a tecla Ctrl pressionada e vá clicando nas opções a serem selecionadas. Selecione as opções 1, 2 e 3 e dê um clique no botão Enviar, conforme indicado na Figura 9.6.

Curso Completo de ASP.NET - Júlio Battisti
Figura 9.6 Utilizando o controle ListBox – chap9ex4.aspx.

No evento Click, do botão Enviar, utilizamos o seguinte código, para informar o primeiro item selecionado:

       void Enviar_Click(Object sender, EventArgs e)

          if (ListBox1.SelectedIndex > -1)

            Label1.Text="  O primeiro item que você selecionou foi: " +

ListBox1.SelectedItem.Text;

O comando ListBox1.SelectedItem.Text é que retorna o texto do primeiro item selecionado.

NOTA: Nos Capítulos 10 e 11 veremos exemplos de utilização das propriedades DataSource, DataTextField e DataValueField, onde os items do controle ListBox serão obtidos a partir de uma fonte de dados.