Visão Geral Sobre Controles ListBox do Servidor Web

Artigo
10/15/2014

O controle ListBox do servidor Web permite que os usuários selecionem um ou mais itens de uma lista pré-definida.

Esse tópico contém:

Cenários
Recursos
Segundo plano
Exemplos de código
Referência de Classe

Cenários

Use o controle ListBox de servidor Web quando você deseja exibir vários itens ao mesmo tempo e permitir aos usuários selecionar um ou mais itens em uma lista predefinida.O controle ListBox difere de um controle DropDownList por que ele pode exibir vários itens ao mesmo tempo e que ele permite que o usuário selecionar vários itens.

Voltar ao topo

Recursos

Você pode usar o controle ListBox para:

Definir o controle para exibir um número específico de itens.
Definir o tamanho do controle em pixels.
Usar vinculação de dados para especificar a lista de itens a exibir.
Determine qual item ou itens estão selecionados.
Especificar o item ou itens selecionados através de programação.

Voltar ao topo

Segundo plano

O controle ListBox normalmente é usado para exibir mais de um item de uma só vez.Você pode controlar a aparência da lista das seguintes maneiras:

Número de linhas exibidas.Você pode definir o controle para exibir um número específico de itens.Se o controle contém mais itens do que isso, ele exibirá um barra de rolagem vertical.
Altura e LarguraVocê pode definir o tamanho do controle usando pixels.Nesse caso, o controle ignorará o número de linhas que você definiu e exibe quantos caberão na altura do controle.Alguns navegadores não oferecem suporte para definir a altura e largura em pixels e usará a contagem de linha para a configuração em vez disso.

Como com outros controles de servidor Web, você pode usar objetos de estilo para especificar a aparência do controle.Para obter detalhes, consulte:Controle de Servidor Web do ASP.NET e Estilos CSS.

Lista de itens

O controle ListBox é um recipiente para um ou mais itens da lista.Cada item da lista é um objeto do tipo ListItem com suas próprias propriedades.Essas propriedades são descritas na tabela a seguir.

Propriedade	Descrição
Text	Especifica o texto que é exibido na lista.
Value	Contém o valor que está associado a um item.A definição dessa propriedade permite que você associe um valor a um item específico sem exibi-lo.Por exemplo, você pode definir a propriedade Text para o nome de uma cor e a propriedade Value para sua representação hexadecimal.
Selected	Indica se o item está selecionado no momento.

Para trabalhar com itens programaticamente, você trabalha com a coleção de Items do controle ListBox.A coleção de Items é uma coleção padrão, e você pode adicionar objetos de item a ela, excluir itens, limpar a coleção e assim por diante.

O item selecionado fica disponível na propriedade SelectedItem do controle ListBox.Se o controle está configurado para modo de única seleção, essa propriedade retornará o item selecionado.Se o controle for definido para o modo várias seleções, obter os itens selecionados fazendo um loop através da coleção inteira de Items e examinando a propriedade Selected de cada item.

Seleção Única versus Múltipla

Normalmente, os usuários podem selecionar um único item na lista, clicando nele.Se você definir o controle ListBox para permitir seleções múltiplas, os usuários podem mantenher pressionada a tecla CTRL ou SHIFT enquanto clicam para selecionar vários itens.

Vinculando dados ao controle

Você pode usar um controle ListBox de servidor Web para listar as opções disponibilizadas para a página usando um controle da fonte de dados.Cada item do controle ListBox corresponde a um item de fonte de dados, geralmente um registro de dados individual.

O controle exibe um campo da fonte.Opcionalmente, você pode vincular o controle a um segundo campo para definir o valor de um item, que não é exibido.

Como ocorre com outros controles do servidor Web, você pode vincular qualquer propriedade do controle, tais como a cor ou tamanho do controle, a dados.Para obter detalhes, consulte:Como: popular a lista servidor Web controles a partir de fontes de dados.

Eventos de ListBox

O controle ListBox gera o evento SelectedIndexChanged quando os usuários selecionam um item.Por padrão, esse evento não faz com que a página seja lançado para o servidor, mas você pode fazer com que o controle force um postback imediato definindo a propriedade AutoPostBack como true.

Observação:
A capacidade autopostback requer que o navegador tenha suporte a ECMAScript (JScript, JavaScript) e que o script esteja ativado no navegador do usuário.