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 |
---|---|
Especifica o texto que é exibido na lista. |
|
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. |
|
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 |
---|---|
A classe principal para o controle. |
|
A classe que representa cada item de lista suspensa. |
Voltar ao topo