Compartilhar via


Visão geral do controle DropDownList do servidor Web

DropDownList O controle de servidor Web permite que os usuários selecionem um único item de uma lista suspensa pré-definida.

Esse tópico contém:

  • Recursos

  • Segundo plano

  • Exemplos de código

  • Referência de Classe

  • Recursos adicionais

Recursos

Você pode usar o controle DropDownList para:

  • Definir o tamanho do controle em pixels.

  • Usar vinculação de dados para especificar a lista de itens a exibir.

  • Determine qual item é selecionado.

  • Especificar o item selecionado de forma programática.

Voltar ao topo

Segundo plano

O controle de servidor Web DropDownList permite que os usuários selecionem um item em uma lista pré-definida.Ele difere do controle ListBox do servidor Web em que a lista de itens permanecerá oculta até que os usuários cliquem no botão suspenso.Além disso, o controle DropDownList não tem suporte para modo de várias seleções.

Modificar a aparência do controle DropDownList

Você pode controlar a aparência do controle DropDownList definindo sua altura e largura em pixels.Alguns navegadores não ofereçam suporte para definir a altura e largura em pixels e usará a contagem de linha para a configuração em vez disso.

Você não pode especificar o número de itens que são exibidos na lista quando os usuários clicam no botão drop-down.O comprimento da lista exibida é determinada pelo navegador.

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

Lista de itens

O controle DropDownList é realmente um recipiente para os itens da lista, que são do tipo ListItem.Cada objeto ListItem é um objeto separado 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 por programação, você trabalha com a coleção Items do controle DropDownList.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 DropDownList.

Vinculando dados ao controle

Você pode usar um controle DropDownList de servidor Web para listar as opções disponibilizadas para a página usando um controle da fonte de dados.Cada item do controle DropDownList 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: dePderdeedeedendecdehdeederde deLdeidesdetdeade deWdeedebde deSdeederdevdeederde decdeodendetderdeodeldeedesde deddeede deudemdeade defdeodendetdeede deddeede deDdeadeddeodesdeddeodesde.

Eventos do DropDownList

O controle DropDownList gera o evento SelectedIndexChanged quando os usuários selecionam um item.Por padrão, esse evento não ocasiona a página ser postada no servidor.No entanto, você pode causar o controle para forçar uma postagem imediata 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.

Voltar ao topo

Exemplos de código

Como: Adicionar controles de servidor Web DropDownList a uma página de Web Forms

Como: Determine the seleção in lista servidor Web Controls

Como: Responder a alterações na lista de controles do servidor Web

Como: Adicionar itens em controles de lista do servidor Web

Como: popular a lista servidor Web controles a partir de fontes de dados

Como: conjunto a seleção em controles de lista do servidor Web

Voltar ao topo

Referência de Classe

A tabela seguinte lista as classes que estão relacionadas ao controle DropDownList.

Membro

Descrição

DropDownList

A classe principal para o controle.

ListItem

A classe que representa cada item de lista suspensa.

Voltar ao topo

Consulte também

Referência

Visão Geral Sobre Controles ListBox do Servidor Web