Partilhar via


Visão Geral do Controle de Servidor Web BulletedList

O controle BulletedList cria uma lista não ordenada ou ordenada (numerada) dos itens que serão processados como ul HTML ou elementos ol, respectivamente.

Esse tópico contém:

  • Cenários

  • Recursos

  • Segundo plano

  • Tópicos de demonstração e explicação passo a passo

  • Referência de Classe

Cenários

Use o controle BulletedList para fazer o seguinte:

  • Especificar a aparência de itens e os marcadores ou números em uma lista.

  • Definir os itens da lista estaticamente ou vinculando o controle aos dados.

  • Responder a cliques do usuário nos itens.

Voltar ao topo

Recursos

Ao usar o controle BulletedList, você pode fazer o seguinte:

  • Personalizar a aparência dos marcadores e números.

  • Especificar como cada item na lista é processado, como um hiperlink, texto estático, ou como um botão de link.

  • Fornecer a lógica para executar tarefas específicas do aplicativo quando um usuário clica em um item.

Voltar ao topo

Segundo plano

O controle BulletedList deriva da mesma classe ListControl que ListBox, DropDownList e outros controles de lista ASP.NET.Portanto, usando o controle BulletedList é como trabalhar com esses controles.Você pode definir itens de lista para o controle BulletedList criando itens estáticos ou vinculando o controle a uma fonte de dados.Se você souber em tempo de design que itens que você deseja exibir, você pode definir o coleção Items de controles para um conjunto de itens individuais com marcação.Se os itens a serem exibidos forem dinâmicos, você pode criar a coleção de itens no código em tempo de execução.Para obter detalhes, consulte:Como: Adicionar itens em controles de lista do servidor Web.

Como alternativa, você pode vincular o controle a uma fonte de dados que contém as informações que você deseja exibir.Para obter detalhes, consulte:Como: popular a lista servidor Web controles a partir de fontes de dados.

Você pode combinar itens estáticos e listas associadas a dados, definindo a propriedade AppendDataBoundItems do controle para true.

Quando você define itens para o BulletedList controle, você definir duas propriedades: the Text propriedade e o Value propriedade. A propriedade Text define que controle são exibidos na página.A propriedade Value define um segundo valor que não será exibido, mas que talvez queira retornar quando um usuário seleciona um item.Por exemplo, você pode exibir um nome de funcionário como o texto de um item, mas usar a identificação de funcionário como o valor.Quando os usuários clicarem no item, você pode ler o valor diretamente.

Observação de segurança:

Não use dados confidenciais, como números de cliente, para a propriedade valor de um controle BulletedList.Embora ele seja não estiver visível, as configurações da propriedade Value dos itens individuais são processadas na página, onde os usuários podem facilmente lê-los no código fonte da página.

Personalizando a Aparência de uma Lista de Itens

O controle BulletedList pode processar marcadores ou números, de acordo com a configuração da propriedade BulletStyle.Se o controle estiver definido como processar marcadores, você poderá selecionar a partir de campos de estilos de marcador predefinidos que correspondam aos estilos de marcador padrão HTML, tais como aquelas representado pelos campos Disc, Circle e Square.

Observação:

Navegadores individuais variam como eles processem marcadores, e alguns navegadores não oferecem suporte para determinados estilos do marcador, como o campo Disc.

Você pode especificar uma imagem personalizada que será exibida no lugar do marcador.

Se o controle estiver definido para processar os números, você pode selecionar uma das opções de numeração padrão do HTML, como os campos LowerAlpha, UpperAlpha, LowerRoman e UpperAlpha.Definindo a propriedade FirstBulletNumber, você também pode especificar um número inicial para a sequência.

Especificando o Modo de Exibição de Item

O controle BulletedList pode exibir itens da lista como qualquer uma das seguintes:

  • Static text   O texto exibido pelo controle é não interativo.

  • Controles T:System.Web.UI.WebControls.HyperLink   Usuários podem clicar em links para navegar para outra página.Você deve fornecer um URL de destino com a propriedade Value dos itens individuais.

  • LinkButtoncontroles Usuários podem clicar em itens individuais e o controle executa um postback.

Respondendo a Seleção do Usuário

Se o controle BulletedList estiver configurado para exibir itens individuais como controles LinkButton, o controle executa um postback quando um usuário clica em um item.A postagem dispara o evento Click do controle BulletedList, onde você pode fornecer lógica para executar tarefas específicas do aplicativo.O evento passa a você o número de índice do item que foi clicado.Para obter detalhes, consulte:Como: Responder a cliques do usuário nos controles BulletedList do servidor Web.

Tópicos de demonstração e explicação passo a passo

Referência de Classe

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

Membro

Descrição

BulletedList

A classe principal para o controle.

BulletedListDisplayMode

Uma enumeração que especifica o comportamento de exibição de cada item.

BulletedListEventArgs

Os dados do evento que indicam o índice do item selecionado.

BulletedListEventHandler

O método que manipula o evento Click de um controle BulletedList.

BulletStyle

Uma enumeração que especifica os tipos de marcadores, números ou letras que podem ser exibidas.

Voltar ao topo

Consulte também

Tarefas

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