BulletedList Classe

Referência

Definição

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Cria um controle que gera uma lista de itens em um formato com marcadores.

public ref class BulletedList : System::Web::UI::WebControls::ListControl, System::Web::UI::IPostBackEventHandler

public class BulletedList : System.Web.UI.WebControls.ListControl, System.Web.UI.IPostBackEventHandler

type BulletedList = class
    inherit ListControl
    interface IPostBackEventHandler

Public Class BulletedList
Inherits ListControl
Implements IPostBackEventHandler

Herança: Object

Control

WebControl

BaseDataBoundControl

DataBoundControl

ListControl
BulletedList

Implementações: IPostBackEventHandler

Exemplos

Esta seção contém dois exemplos de código. O primeiro exemplo de código demonstra como criar um BulletedList controle com itens de lista formatados como botões de link. O segundo exemplo de código demonstra como criar um BulletedList controle usando a associação de dados para especificar os itens da lista.

O exemplo de código a seguir demonstra como criar um BulletedList controle com itens de lista formatados como botões de link. O texto é exibido em um Label controle quando um item de lista é clicado.

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
  <title>BulletedList Click Example</title>
  <script runat="server">


    void ItemsBulletedList_Click(object sender, System.Web.UI.WebControls.BulletedListEventArgs e)
    {

        // Change the message displayed in the label based on the index
        // of the list item that was clicked.
        switch (e.Index) 
      {
            case 0:
                Message.Text = "You clicked list item 1.";
                break;
            case 1:
                Message.Text = "You clicked list item 2.";
                break;
            case 2:
                Message.Text = "You clicked list item 3.";
                break;
            default:
                throw new Exception("You did not click a valid list item.");
                break;
        }

    }

  </script>

</head>
<body>

  <h3>BulletedList Click Example</h3>

  <form id="form1" runat="server">
            
    <p>Click on an item in the list to raise the Click event.</p> 
        
    <asp:BulletedList id="ItemsBulletedList" 
      BulletStyle="Disc"
      DisplayMode="LinkButton"
      OnClick="ItemsBulletedList_Click"
      runat="server">
        <asp:ListItem Value="http://www.cohowinery.com">Coho Winery</asp:ListItem>
        <asp:ListItem Value="http://www.contoso.com">Contoso, Ltd.</asp:ListItem>
        <asp:ListItem Value="http://www.tailspintoys.com">Tailspin Toys</asp:ListItem>
    </asp:BulletedList>
            
    <asp:Label id="Message" 
      Font-Size="12"
      Width="168px" 
      Font-Bold="True" 
      runat="server"
      AssociatedControlID="ItemsBulletedList"/>

   </form>

</body>
</html>

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
  <title>BulletedList Click Example</title>
  <script runat="server">

    Sub ItemsBulletedList_Click(ByVal sender As Object, _
                                ByVal e As System.Web.UI.WebControls.BulletedListEventArgs)
      
      ' Change the message displayed in the label based on the index
      ' of the list item that was clicked.
      Select Case (e.Index)
        Case 0
          Message.Text = "You clicked list item 1."
        Case 1
          Message.Text = "You clicked list item 2."
        Case 2
          Message.Text = "You clicked list item 3."
        Case Else
          Throw New Exception("You did not click a valid list item.")
      End Select

    End Sub

  </script>

</head>
<body>

  <h3>BulletedList Click Example</h3>

  <form id="form1" runat="server">
            
    <p>Click on an item in the list to raise the Click event.</p> 
        
    <asp:BulletedList id="ItemsBulletedList" 
      BulletStyle="Disc"
      DisplayMode="LinkButton" 
      OnClick="ItemsBulletedList_Click"
      runat="server">
        <asp:ListItem Value="http://www.cohowinery.com">Coho Winery</asp:ListItem>
        <asp:ListItem Value="http://www.contoso.com">Contoso, Ltd.</asp:ListItem>
        <asp:ListItem Value="http://www.tailspintoys.com">Tailspin Toys</asp:ListItem>
    </asp:BulletedList>
            
    <asp:Label id="Message"
      Font-Size="12"
      Width="168px"
      Font-Bold="True"
      runat="server"
      AssociatedControlID="ItemsBulletedList"/>

   </form>

</body>
</html>

O exemplo de código a seguir demonstra como criar um BulletedList controle usando a associação de dados para especificar os itens da lista. Os itens de lista são formatados como botões de link. O texto é exibido em um Label controle quando um item de lista é clicado.

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
  <title>BulletedList Class Data Binding Example</title>
  <script runat="server">

    void ProductsBulletedList_Click(object sender, 
      System.Web.UI.WebControls.BulletedListEventArgs e)
    {

        // Change the message displayed in the label based on the index
        // of the list item that was clicked.
        switch (e.Index) 
      {
            case 0:
                Message.Text = "Product 1 was clicked";
                break;
            case 1:
                Message.Text = "Product 2 was clicked";
                break;
            case 2:
                Message.Text = "Product 3 was clicked";
                break;
            case 3:
                Message.Text = "Product 4 was clicked";
                break;
            default:
                throw new Exception("You must click a valid list item.");
                break;
        }

  }

  </script>
    
</head>
<body>

  <h3>BulletedList Class Data Binding Example</h3>

  <form id="form1" runat="server">
            
    <p>Click on an item in the list.</p>

    <asp:BulletedList id="ProductsBulletedList" 
      BulletStyle="Disc"
      DisplayMode="LinkButton"
      DataTextField="ProductName"
      DataSourceID="SqlDataSource1"
      OnClick="ProductsBulletedList_Click"
      runat="server">                    
    </asp:BulletedList>
        
    <asp:SqlDataSource id="SqlDataSource1"          
      ConnectionString="<%$ ConnectionStrings:NorthWindConnection%>"
      runat="server"
      SelectCommand="SELECT * FROM [Products] Where ProductID < 5">
    </asp:SqlDataSource>

    <asp:Label id="Message" 
      Font-Size="12"
      Width="168px" 
      Font-Bold="True" 
      runat="server"/>

   </form>

</body>
</html>

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
  <title>BulletedList Class Data Binding Example</title>
  <script runat="server">

    Sub ProductsBulletedList_Click(ByVal sender As Object, _
                                   ByVal e As System.Web.UI.WebControls.BulletedListEventArgs)
      
      ' Change the message displayed in the label based on the index
      ' of the list item that was clicked.
      Select Case (e.Index)
        Case 0
          Message.Text = "Product 1 was clicked"
        Case 1
          Message.Text = "Product 2 was clicked"
        Case 2
          Message.Text = "Product 3 was clicked"
        Case 3
          Message.Text = "Product 4 was clicked"
        Case Else
          Throw New Exception("You must click a valid list item.")
      End Select

    End Sub

  </script>
    
</head>
<body>

  <h3>BulletedList Class Data Binding Example</h3>

  <form id="form1" runat="server">
            
    <p>Click on an item in the list.</p>

    <asp:BulletedList id="ProductsBulletedList" 
      BulletStyle="Disc"
      DisplayMode="LinkButton"
      DataTextField="ProductName"
      DataSourceID="SqlDataSource1"
      OnClick="ProductsBulletedList_Click"
      runat="server">                    
    </asp:BulletedList>
        
    <asp:SqlDataSource id="SqlDataSource1"          
      ConnectionString="<%$ ConnectionStrings:NorthWindConnection%>"
      runat="server"
      SelectCommand="SELECT * FROM [Products] Where ProductID < 5">
    </asp:SqlDataSource>

    <asp:Label id="Message" 
      Font-Size="12"
      Width="168px" 
      Font-Bold="True" 
      runat="server"/>

   </form>

</body>
</html>

Comentários

Neste tópico:

Introdução
Acessibilidade
Sintaxe declarativa

Introdução

Use o BulletedList controle para criar uma lista de itens formatados com marcadores. Para especificar os itens de lista individuais que você deseja que apareçam em um BulletedList controle, coloque um ListItem objeto para cada entrada entre as marcas de abertura e fechamento do BulletedList controle.

Para especificar o tipo de marcador a ser usado para exibir itens de lista em um BulletedList controle, defina a BulletStyle propriedade como um dos tipos de marcadores definidos pela BulletStyle enumeração . A tabela a seguir lista os estilos de marcador disponíveis.

Estilo de marcador	Descrição
NotSet	Não definida.
Numbered	Um número.
LowerAlpha	Uma letra minúscula.
UpperAlpha	Uma letra maiúscula.
LowerRoman	Um numeral romano minúsculo.
UpperRoman	Um numeral romano maiúsculo.
Disc	Um círculo cheio.
Circle	Um círculo vazio.
Square	Um quadrado cheio.
CustomImage	Uma imagem personalizada.

Use a FirstBulletNumber propriedade para especificar o valor que inicia a numeração de itens de lista em um controle ordenado BulletedList . O valor atribuído à FirstBulletNumber propriedade será ignorado se a BulletStyle propriedade for definida como o Disccampo , Square Circle, ou CustomImage . Se você definir a BulletStyle propriedade como o valor de CustomImage para especificar uma imagem personalizada para o marcador, defina a BulletImageUrl propriedade também para especificar o local do arquivo de imagem.

Para especificar o comportamento de exibição dos itens de lista em um BulletedList, defina a DisplayMode propriedade como um dos valores definidos pela BulletedListDisplayMode enumeração . Os comportamentos de exibição definidos são Text, HyperLinke LinkButton.

Quando um hiperlink é clicado, ele navega para uma URL. Use a Value propriedade para especificar a URL para a qual um hiperlink navega. Use a Target propriedade para especificar o quadro ou a janela que exibe a página da Web para a qual é navegada quando um hiperlink é clicado.

Quando a DisplayMode propriedade é definida LinkButtoncomo , o BulletedList controle exibe itens de lista como links que postam de volta no servidor quando clicado. Para controlar programaticamente as ações executadas quando um botão de link é clicado, forneça um manipulador de eventos para o Click evento. Observe que as SelectedIndex propriedades e SelectedItem são herdadas da ListControl classe e não são aplicáveis ao BulletedList controle. Use os dados de evento da BulletedListEventArgs classe para determinar o índice do botão de link em um BulletedList que foi clicado.

O BulletedList controle também dá suporte à associação de dados. Para associar o BulletedList a uma fonte de dados, você pode usar qualquer um dos mecanismos de associação de dados fornecidos. Para obter mais informações, consulte Associação a bancos de dados.

Acessibilidade

A marcação renderizada por padrão para esse controle pode não estar em conformidade com os padrões de acessibilidade, como as diretrizes de prioridade 1.0 (WCAG) das Diretrizes de Acessibilidade de Conteúdo da Web 1.0 (WCAG). Para obter detalhes sobre o suporte de acessibilidade para esse controle, consulte Controles de ASP.NET e Acessibilidade.

Sintaxe declarativa

<asp:BulletedList
    AccessKey="string"
    AppendDataBoundItems="True|False"
    AutoPostBack="True|False"
    BackColor="color name|#dddddd"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    BulletImageUrl="uri"
    BulletStyle="NotSet|Numbered|LowerAlpha|UpperAlpha|LowerRoman|
        UpperRoman|Disc|Circle|Square|CustomImage"
    CausesValidation="True|False"
    CssClass="string"
    DataMember="string"
    DataSource="string"
    DataSourceID="string"
    DataTextField="string"
    DataTextFormatString="string"
    DataValueField="string"
    DisplayMode="Text|HyperLink|LinkButton"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    FirstBulletNumber="integer"
    Font-Bold="True|False"
    Font-Italic="True|False"
    Font-Names="string"
    Font-Overline="True|False"
    Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|
        Medium|Large|X-Large|XX-Large"
    Font-Strikeout="True|False"
    Font-Underline="True|False"
    ForeColor="color name|#dddddd"
    Height="size"
    ID="string"
    OnClick="Click event handler"
    OnDataBinding="DataBinding event handler"
    OnDataBound="DataBound event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnSelectedIndexChanged="SelectedIndexChanged event handler"
    OnTextChanged="TextChanged event handler"
    OnUnload="Unload event handler"
    runat="server"
    SkinID="string"
    Style="string"
    TabIndex="integer"
    Target="string|_blank|_parent|_search|_self|_top"
    ToolTip="string"
    ValidationGroup="string"
    Visible="True|False"
    Width="size"
>
            <asp:ListItem
                Enabled="True|False"
                Selected="True|False"
                Text="string"
                Value="string"
            />
</asp:BulletedList>

Construtores

BulletedList()

Inicializa uma nova instância da classe BulletedList.

Propriedades

AccessKey	Obtém ou define a tecla de acesso que permite navegar rapidamente para o controle do servidor Web. (Herdado de WebControl)
Adapter	Obtém o adaptador específico de navegador para o controle. (Herdado de Control)
AppendDataBoundItems	Obtém ou define um valor que indica se os itens da lista são apagados antes da vinculação de dados. (Herdado de ListControl)
AppRelativeTemplateSourceDirectory	Obtém ou define o diretório virtual relativo de aplicativo do objeto Page ou UserControl que contém este controle. (Herdado de Control)
Attributes	Obtém a coleção de atributos arbitrários (somente para renderização) que não correspondem às propriedades do controle. (Herdado de WebControl)
AutoPostBack	Obtém ou define o valor da propriedade AutoPostBack para a classe base.
BackColor	Obtém ou define a cor da tela de fundo do controle do servidor Web. (Herdado de WebControl)
BindingContainer	Obtém o controle que contém a vinculação de dados desse controle. (Herdado de Control)
BorderColor	Obtém ou define a cor da borda do controle Web. (Herdado de WebControl)
BorderStyle	Obtém ou define o estilo de borda do controle de servidor Web. (Herdado de WebControl)
BorderWidth	Obtém ou define a largura da borda do controle de servidor Web. (Herdado de WebControl)
BulletImageUrl	Obtém ou define o caminho para uma imagem a ser exibido para cada marcador em um controle BulletedList.
BulletStyle	Obtém ou define o estilo de marcador do controle BulletedList.
CausesValidation	Obtém ou define um valor que indica se a validação é executada quando se clica em um controle que é derivado da classe ListControl. (Herdado de ListControl)
ChildControlsCreated	Obtém um valor que indica se os controles filho do controle de servidor foram criados. (Herdado de Control)
ClientID	Obtém a ID de controle de marcação HTML gerada pelo ASP.NET. (Herdado de Control)
ClientIDMode	Obtém ou define o algoritmo usado para gerar o valor da propriedade ClientID. (Herdado de Control)
ClientIDSeparator	Obtém um valor de caractere que representa o caractere separador usado na propriedade ClientID. (Herdado de Control)
Context	Obtém o objeto HttpContext associado ao controle de servidor para a solicitação da Web atual. (Herdado de Control)
Controls	Obtém uma coleção de ControlCollection para o controle.
ControlStyle	Obtém o estilo de um controle de servidor Web. Essa propriedade é usada principalmente por desenvolvedores de controle. (Herdado de WebControl)
ControlStyleCreated	Obtém um valor que indica se um objeto Style foi criado para a propriedade ControlStyle. Essa propriedade é usada principalmente por desenvolvedores de controle. (Herdado de WebControl)
CssClass	Obtém ou define a classe CSS (Folha de Estilos em Cascata) renderizada pelo controle do servidor Web no cliente. (Herdado de WebControl)
DataItemContainer	Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataItemContainer. (Herdado de Control)
DataKeysContainer	Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataKeysControl. (Herdado de Control)
DataMember	Obtém ou define a tabela específica no DataSource para associar ao controle. (Herdado de ListControl)
DataSource	Obtém ou define a fonte de dados que popula os itens do controle de lista. (Herdado de ListControl)
DataSourceID	Obtém ou define a ID do controle do qual o controle associado a dados recupera sua lista de itens de dados. (Herdado de DataBoundControl)
DataSourceObject	Obtém um objeto que implementa a interface IDataSource, que fornece acesso ao conteúdo de dados do objeto. (Herdado de DataBoundControl)
DataTextField	Obtém ou define o campo da fonte de dados que fornece o conteúdo de texto dos itens da lista. (Herdado de ListControl)
DataTextFormatString	Obtém ou define a cadeia de caracteres de formatação usada para controlar como os dados associados ao controle de lista são exibidos. (Herdado de ListControl)
DataValueField	Obtém ou define o campo da fonte de dados que fornece o valor de cada item de lista. (Herdado de ListControl)
DesignMode	Obtém um valor que indica se um controle está sendo usado em uma superfície de design. (Herdado de Control)
DisplayMode	Obtém ou define o modo de exibição da lista de conteúdo em um controle de BulletedList.
Enabled	Obtém ou define um valor que indica se o controle do servidor Web está habilitado. (Herdado de WebControl)
EnableTheming	Obtém ou define um valor que indica se os temas se aplicam a esse controle. (Herdado de WebControl)
EnableViewState	Obtém ou define um valor que indica se o controle de servidor persiste seu estado de exibição e o estado de exibição de quaisquer controles filho que ele contém, para o cliente solicitante. (Herdado de Control)
Events	Obtém uma lista de delegados de manipulador de eventos para o controle. Esta propriedade é somente para leitura. (Herdado de Control)
FirstBulletNumber	Obtém ou define o valor que inicia a numeração de itens de lista em um controle de BulletedList ordenado.
Font	Obtém as propriedades de fonte associadas ao controle do servidor Web. (Herdado de WebControl)
ForeColor	Obtém ou define a cor de primeiro plano (normalmente a cor do texto) do controle de servidor Web. (Herdado de WebControl)
HasAttributes	Obtém um valor que indica se o controle tem atributos definidos. (Herdado de WebControl)
HasChildViewState	Obtém um valor que indica se os controles filho do controle de servidor atual têm alguma configuração de estado de exibição salva. (Herdado de Control)
Height	Obtém ou define a altura do controle do servidor Web. (Herdado de WebControl)
ID	Obtém ou define o identificador programático atribuído ao controle de servidor. (Herdado de Control)
IdSeparator	Obtém o caractere usado para separar identificadores de controle. (Herdado de Control)
Initialized	Obtém um valor que indica se o controle associado a dados foi inicializado. (Herdado de BaseDataBoundControl)
IsBoundUsingDataSourceID	Obtém um valor que indica se a propriedade DataSourceID foi definida. (Herdado de BaseDataBoundControl)
IsChildControlStateCleared	Obtém um valor que indica se os controles contidos dentro deste controle têm estado de controle. (Herdado de Control)
IsDataBindingAutomatic	Obtém um valor que indica se a associação de dados é automática. (Herdado de BaseDataBoundControl)
IsEnabled	Obtém um valor que indica se o controle está habilitado. (Herdado de WebControl)
IsTrackingViewState	Obtém um valor que indica se o controle de servidor está salvando alterações no estado de exibição. (Herdado de Control)
IsUsingModelBinders	Obtém um valor que indica se o model binding está em uso. (Herdado de DataBoundControl)
IsViewStateEnabled	Obtém um valor que indica se o estado de exibição está habilitado para esse controle. (Herdado de Control)
Items	Obtém a coleção de itens no controle de lista. (Herdado de ListControl)
ItemType	Obtém ou define o nome do tipo de item de dados para vinculação de dados com rigidez de tipos. (Herdado de DataBoundControl)
LoadViewStateByID	Obtém um valor que indica se o controle participa do carregamento do estado de exibição por ID em vez do índice. (Herdado de Control)
NamingContainer	Obtém uma referência ao contêiner de nomenclatura do controle do servidor, que cria um namespace exclusivo para diferenciar entre os controles de servidor com o mesmo valor da propriedade ID. (Herdado de Control)
Page	Obtém uma referência para a instância Page que contém o controle de servidor. (Herdado de Control)
Parent	Obtém uma referência ao controle pai do controle de servidor na hierarquia de controle da página. (Herdado de Control)
RenderingCompatibility	Obtém um valor que especifica a versão do ASP.NET com a qual o HTML renderizado será compatível. (Herdado de Control)
RenderWhenDataEmpty	Obtém ou define um valor que indica se o controle é renderizado se a fonte de dados não tiver dados ou se o controle não estiver vinculado a dados.
RequiresDataBinding	Obtém ou define um valor que indica se o método DataBind() deve ser cancelado. (Herdado de BaseDataBoundControl)
SelectArguments	Obtém um objeto DataSourceSelectArguments que o controle associado a dados usa ao recuperar dados de um controle de fonte de dados. (Herdado de DataBoundControl)
SelectedIndex	Obtém ou define o índice baseado em zero do item selecionado no momento em um controle de BulletedList.
SelectedItem	Obtém o item selecionado atualmente em um controle de BulletedList.
SelectedValue	Obtém ou define a propriedade Value do objeto de ListItem selecionado no controle de BulletedList.
SelectMethod	O nome do método a ser chamado para ler os dados. (Herdado de DataBoundControl)
Site	Obtém informações sobre o contêiner que hospeda o controle atual quando renderizados em uma superfície de design. (Herdado de Control)
SkinID	Obtém ou define a capa a ser aplicada ao controle. (Herdado de WebControl)
Style	Obtém uma coleção de atributos de texto que serão renderizados como um atributo de estilo na marca externa do controle de servidor Web. (Herdado de WebControl)
SupportsDisabledAttribute	Obtém um valor que indica se o controle deve definir o atributo `disabled` do elemento HTML renderizado para "desabilitado" quando a propriedade do controle IsEnabled é `false`. (Herdado de BaseDataBoundControl)
TabIndex	Obtém ou define o índice de tabulação do controle do servidor Web. (Herdado de WebControl)
TagKey	Obtém o valor de HtmlTextWriterTag para o controle de BulletedList especificado.
TagName	Obtém o nome da marca de controle. Essa propriedade é usada principalmente por desenvolvedores de controle. (Herdado de WebControl)
Target	Obtém ou define a janela de destino ou quadro no qual exibir o conteúdo da página da Web vinculada quando um hiperlink em um controle BulletedList é clicado.
TemplateControl	Obtém ou define uma referência ao modelo que contém este controle. (Herdado de Control)
TemplateSourceDirectory	Obtém o diretório virtual do Page ou UserControl que contém o controle do servidor atual. (Herdado de Control)
Text	Obtém ou define o texto para o controle de BulletedList.
ToolTip	Obtém ou define o texto exibido quando o ponteiro do mouse passa sobre o controle de servidor Web. (Herdado de WebControl)
UniqueID	Obtém o identificador exclusivo, qualificado segundo a hierarquia, para o controle de servidor. (Herdado de Control)
ValidateRequestMode	Obtém ou define um valor que indica se o controle verifica a entrada do cliente do navegador para valores potencialmente perigosos. (Herdado de Control)
ValidationGroup	Obtém ou define o grupo de controles para o qual o controle derivado da classe ListControl provoca a validação ao fazer o postback para o servidor. (Herdado de ListControl)
ViewState	Obtém um dicionário de informações de estado que permite salvar e restaurar o estado de exibição de um controle de servidor em várias solicitações para a mesma página. (Herdado de Control)
ViewStateIgnoresCase	Obtém um valor que indica se o objeto StateBag não diferencia maiúsculas de minúsculas. (Herdado de Control)
ViewStateMode	Obtém ou define o modo de estado de exibição deste controle. (Herdado de Control)
Visible	Obtém ou define um valor que indica se um controle de servidor é renderizado como uma interface do usuário na página. (Herdado de Control)
Width	Obtém ou define a largura do controle de servidor Web. (Herdado de WebControl)

Métodos

AddAttributesToRender(HtmlTextWriter)	Adiciona os estilos e atributos HTML para um controle BulletedList a ser renderizado para o objeto de HtmlTextWriter especificado.
AddedControl(Control, Int32)	Chamado após um controle filho ser adicionado à coleção Controls do objeto Control. (Herdado de Control)
AddParsedSubObject(Object)	Notifica o controle de servidor de que um elemento, XML ou HTML, foi analisado e adiciona o elemento ao objeto ControlCollection do controle de servidor. (Herdado de Control)
ApplyStyle(Style)	Copia os elementos não vazios do estilo especificado para o controle da Web, substituindo os elementos de estilo existentes no controle. Esse método é usado principalmente por desenvolvedores de controles. (Herdado de WebControl)
ApplyStyleSheetSkin(Page)	Aplica as propriedades de estilo definidas na folha de estilos da página ao controle. (Herdado de Control)
BeginRenderTracing(TextWriter, Object)	Inicia o rastreamento de tempo de design de dados de renderização. (Herdado de Control)
BuildProfileTree(String, Boolean)	Reúne informações sobre o controle de servidor e as envia para a propriedade Trace para serem exibidas quando o rastreamento está habilitado para a página. (Herdado de Control)
ClearCachedClientID()	Define o valor ClientID armazenado em cache como `null`. (Herdado de Control)
ClearChildControlState()	Exclui as informações de estado de controle para os controles filho do controle de servidor. (Herdado de Control)
ClearChildState()	Exclui as informações de estado de exibição e de estado de controle para todos os controles filho do controle de servidor. (Herdado de Control)
ClearChildViewState()	Exclui as informações de estado de exibição para todos os controles filho do controle de servidor. (Herdado de Control)
ClearEffectiveClientIDMode()	Define a propriedade ClientIDMode da instância de controle atual e de quaisquer controles filho para Inherit. (Herdado de Control)
ClearSelection()	Limpa a seleção de lista e define a propriedade Selected de todos os itens como false. (Herdado de ListControl)
ConfirmInitState()	Define o estado inicializado do controle associado a dados. (Herdado de BaseDataBoundControl)
CopyBaseAttributes(WebControl)	Copia as propriedades que não são encapsuladas pelo objeto Style de controle do servidor Web especificado ao controle de servidor Web do qual este método é chamado. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl)
CreateChildControls()	Chamado pela estrutura de página do ASP.NET para notificar os controles do servidor que usam a implementação baseada em composição para criar os controles filho para preparar-se para um postback ou renderização. (Herdado de Control)
CreateControlCollection()	Cria um novo objeto ControlCollection para manter os controles filho (literal e servidor) do controle do servidor. (Herdado de Control)
CreateControlStyle()	Cria o objeto de estilo que é usado internamente pela classe WebControl para implementar todas as propriedades relacionadas a estilo. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl)
CreateDataSourceSelectArguments()	Cria um objeto DataSourceSelectArguments padrão usado pelo controle associado a dados se nenhum argumento é especificado. (Herdado de DataBoundControl)
DataBind()	Associa uma fonte de dados ao controle de servidor chamado e a todos os seus controles filho. (Herdado de BaseDataBoundControl)
DataBind(Boolean)	Associa uma fonte de dados ao controle de servidor invocado e todos os seus controles filho com uma opção para gerar o evento DataBinding. (Herdado de Control)
DataBindChildren()	Associa uma fonte de dados aos controles filho do controle do servidor. (Herdado de Control)
Dispose()	Permite que um controle de servidor execute a limpeza final antes do lançamento da memória. (Herdado de Control)
EndRenderTracing(TextWriter, Object)	Encerra o rastreamento de tempo de design de dados de renderização. (Herdado de Control)
EnsureChildControls()	Determinará se o controle de servidor contiver controles filho. Se ele não contiver, ele criará controles filho. (Herdado de Control)
EnsureDataBound()	Chamará o método DataBind() se a propriedade DataSourceID estiver definida e o controle associado a dados estiver marcado para exigir a associação. (Herdado de BaseDataBoundControl)
EnsureID()	Cria um identificador para controles que não têm um identificador atribuído. (Herdado de Control)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
FindControl(String)	Procura o atual contêiner de nomenclatura de um controle de servidor com o parâmetro `id` especificado. (Herdado de Control)
FindControl(String, Int32)	Procura o contêiner de nomenclatura atual para um controle de servidor com o `id` especificado e um inteiro especificado no parâmetro `pathOffset`, que auxilia na pesquisa. Você não deve substituir esta versão do método FindControl. (Herdado de Control)
Focus()	Define o foco de entrada para um controle. (Herdado de Control)
GetData()	Recupera um objeto DataSourceView que o controle com associação de dados usa para executar operações de dados. (Herdado de DataBoundControl)
GetDataSource()	Recupera a interface IDataSource à qual o controle associado a dados está associado, se houver. (Herdado de DataBoundControl)
GetDesignModeState()	Obtém os dados de tempo de design para um controle. (Herdado de Control)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetRouteUrl(Object)	Obtém a URL que corresponde a um conjunto de parâmetros de rota. (Herdado de Control)
GetRouteUrl(RouteValueDictionary)	Obtém a URL que corresponde a um conjunto de parâmetros de rota. (Herdado de Control)
GetRouteUrl(String, Object)	Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota. (Herdado de Control)
GetRouteUrl(String, RouteValueDictionary)	Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota. (Herdado de Control)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
GetUniqueIDRelativeTo(Control)	Retorna a parte prefixada da propriedade UniqueID do controle especificado. (Herdado de Control)
HasControls()	Determina se o controle de servidor contém algum controle filho. (Herdado de Control)
HasEvents()	Retorna um valor que indica se os eventos são registrados para o controle ou qualquer controle filho. (Herdado de Control)
IsLiteralContent()	Determina se o controle de servidor contém apenas o conteúdo literal. (Herdado de Control)
LoadControlState(Object)	Restaura informações de estado de controle de uma solicitação de página anterior que foi salva pelo método SaveControlState(). (Herdado de Control)
LoadViewState(Object)	Carrega o estado de exibição salvo anteriormente do controle DetailsView. (Herdado de ListControl)
MapPathSecure(String)	Recupera o caminho físico para o qual um caminho virtual é mapeado, relativo ou virtual. (Herdado de Control)
MarkAsDataBound()	Define o estado do controle em estado de exibição como associado com êxito aos dados. (Herdado de DataBoundControl)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
MergeStyle(Style)	Copia os elementos não vazios do estilo especificado para o controle da Web, mas não substituirá os elementos de estilo existentes do controle. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl)
OnBubbleEvent(Object, EventArgs)	Determina se o evento do controle de servidor é passado um nível acima da hierarquia de controle de servidor da interface do usuário da página. (Herdado de Control)
OnClick(BulletedListEventArgs)	Aciona o evento Click do controle BulletedList.
OnCreatingModelDataSource(CreatingModelDataSourceEventArgs)	Aciona o evento CreatingModelDataSource. (Herdado de DataBoundControl)
OnDataBinding(EventArgs)	Aciona o evento DataBinding. (Herdado de ListControl)
OnDataBound(EventArgs)	Aciona o evento DataBound. (Herdado de BaseDataBoundControl)
OnDataPropertyChanged()	Associa novamente o controle associado a dados a seus dados após a alteração de uma das propriedades de identificação da fonte de dados base. (Herdado de DataBoundControl)
OnDataSourceViewChanged(Object, EventArgs)	Aciona o evento DataSourceViewChanged. (Herdado de DataBoundControl)
OnInit(EventArgs)	Manipula o evento Init. (Herdado de BaseDataBoundControl)
OnLoad(EventArgs)	Manipula o evento Load. (Herdado de DataBoundControl)
OnPagePreLoad(Object, EventArgs)	Define o estado inicializado do controle associado a dados antes do carregamento do controle. (Herdado de DataBoundControl)
OnPreRender(EventArgs)	Aciona o evento PreRender. (Herdado de ListControl)
OnSelectedIndexChanged(EventArgs)	Aciona o evento SelectedIndexChanged. Isso permite que você forneça um manipulador personalizado para o evento. (Herdado de ListControl)
OnTextChanged(EventArgs)	Aciona o evento TextChanged. (Herdado de ListControl)
OnUnload(EventArgs)	Aciona o evento Unload. (Herdado de Control)
OpenFile(String)	Obtém um Stream usado para ler um arquivo. (Herdado de Control)
PerformDataBinding(IEnumerable)	Associa a fonte de dados especificada para o controle derivado da classe ListControl. (Herdado de ListControl)
PerformSelect()	Recupera dados da fonte de dados associada. (Herdado de ListControl)
RaiseBubbleEvent(Object, EventArgs)	Atribui quaisquer fontes de evento e suas informações para o pai do controle. (Herdado de Control)
RaisePostBackEvent(String)	Aciona eventos para o controle BulletedList quando o postback de um formulário para o servidor é executado.
RemovedControl(Control)	Chamado após um controle filho ser removido da coleção Controls do objeto Control. (Herdado de Control)
Render(HtmlTextWriter)	Grava o conteúdo do controle de BulletedList no objeto de HtmlTextWriter especificado para exibição no cliente.
RenderBeginTag(HtmlTextWriter)	Renderiza a marca de abertura HTML do controle para o gravador especificado. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl)
RenderBulletText(ListItem, Int32, HtmlTextWriter)	Renderiza o texto com marcadores para cada item de lista em um controle de BulletedList.
RenderChildren(HtmlTextWriter)	Gera o conteúdo dos filhos de um controle de servidor para um objeto HtmlTextWriter fornecido, que grava o conteúdo a ser renderizado no cliente. (Herdado de Control)
RenderContents(HtmlTextWriter)	Renderiza os itens da lista de um controle de BulletedList como marcadores no HtmlTextWriter especificado.
RenderControl(HtmlTextWriter)	Gera o conteúdo do controle de servidor para um objeto HtmlTextWriter fornecido e armazena informações de rastreamento sobre o controle caso o rastreamento esteja habilitado. (Herdado de Control)
RenderControl(HtmlTextWriter, ControlAdapter)	Gera o conteúdo do controle de servidor a um objeto HtmlTextWriter fornecido usando um objeto ControlAdapter fornecido. (Herdado de Control)
RenderEndTag(HtmlTextWriter)	Renderiza a marca de fechamento HTML do controle para o gravador especificado. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl)
ResolveAdapter()	Obtém o adaptador de controle responsável por renderizar o controle especificado. (Herdado de Control)
ResolveClientUrl(String)	Obtém uma URL que pode ser usada pelo navegador. (Herdado de Control)
ResolveUrl(String)	Converte uma URL em uma que possa ser usada no cliente solicitante. (Herdado de Control)
SaveControlState()	Salva as alterações de estado do controle de servidor que ocorreram desde a hora em que ocorreu o postback da página no servidor. (Herdado de Control)
SaveViewState()	Salva o estado de exibição atual do controle derivado de ListControl e os itens que ele contém. (Herdado de ListControl)
SetDesignModeState(IDictionary)	Define os dados de tempo de design para um controle. (Herdado de Control)
SetPostDataSelection(Int32)	Define a propriedade Selected de um controle ListItem depois que uma página for publicada. (Herdado de ListControl)
SetRenderMethodDelegate(RenderMethod)	Atribui um delegado do manipulador de eventos para renderizar o controle de servidor e seu conteúdo em seu controle pai. (Herdado de Control)
SetTraceData(Object, Object)	Define os dados de rastreamento para o rastreamento de tempo de design dos dados de renderização, usando a chave e o valor de dados de rastreamento. (Herdado de Control)
SetTraceData(Object, Object, Object)	Define os dados de rastreamento para o rastreamento de tempo de design dos dados de renderização, usando o objeto rastreado, a chave e o valor de dados de rastreamento. (Herdado de Control)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
TrackViewState()	Marca o ponto inicial no qual começar a acompanhar e salvar as alterações de estado de exibição a um controle derivado de ListControl. (Herdado de ListControl)
ValidateDataSource(Object)	Verifica se o objeto ao qual um controle associado a dados está associado é um objeto com o qual ele pode trabalhar. (Herdado de DataBoundControl)
VerifyMultiSelect()	Determina se o controle de lista é compatível com o modo de seleção múltipla. (Herdado de ListControl)

Eventos

CallingDataMethods	Ocorre quando os métodos de dados estão sendo chamados. (Herdado de DataBoundControl)
Click	Ocorre ao clicar em um botão de link em um controle BulletedList.
CreatingModelDataSource	Ocorre quando o objeto ModelDataSource está sendo criado. (Herdado de DataBoundControl)
DataBinding	Ocorre quando o controle de servidor é associado a uma fonte de dados. (Herdado de Control)
DataBound	Ocorre após o controle de servidor ser associado a uma fonte de dados. (Herdado de BaseDataBoundControl)
Disposed	Ocorre quando um controle de servidor é liberado da memória, que é o último estágio do ciclo de vida de controle de servidor quando uma página ASP.NET é solicitada. (Herdado de Control)
Init	Ocorre quando o controle de servidor é inicializado, que é a primeira etapa do ciclo de vida. (Herdado de Control)
Load	Ocorre quando o controle de servidor é carregado no objeto Page. (Herdado de Control)
PreRender	Ocorre depois que o objeto Control é carregado, mas antes da renderização. (Herdado de Control)
SelectedIndexChanged	Ocorre quando a seleção do controle de lista é alterada entre posts no servidor. (Herdado de ListControl)
TextChanged	Ocorre quando as propriedades Text e SelectedValue são alteradas. (Herdado de ListControl)
Unload	Ocorre quando o controle de servidor é descarregado da memória. (Herdado de Control)

Implantações explícitas de interface

IAttributeAccessor.GetAttribute(String)	Obtém um atributo do controle da Web com o nome especificado. (Herdado de WebControl)
IAttributeAccessor.SetAttribute(String, String)	Define um atributo do controle da Web para o nome e o valor especificados. (Herdado de WebControl)
IControlBuilderAccessor.ControlBuilder	Para obter uma descrição desse membro, confira ControlBuilder. (Herdado de Control)
IControlDesignerAccessor.GetDesignModeState()	Para obter uma descrição desse membro, confira GetDesignModeState(). (Herdado de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Para obter uma descrição desse membro, confira SetDesignModeState(IDictionary). (Herdado de Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Para obter uma descrição desse membro, confira SetOwnerControl(Control). (Herdado de Control)
IControlDesignerAccessor.UserData	Para obter uma descrição desse membro, confira UserData. (Herdado de Control)
IDataBindingsAccessor.DataBindings	Para obter uma descrição desse membro, confira DataBindings. (Herdado de Control)
IDataBindingsAccessor.HasDataBindings	Para obter uma descrição desse membro, confira HasDataBindings. (Herdado de Control)
IExpressionsAccessor.Expressions	Para obter uma descrição desse membro, confira Expressions. (Herdado de Control)
IExpressionsAccessor.HasExpressions	Para obter uma descrição desse membro, confira HasExpressions. (Herdado de Control)
IParserAccessor.AddParsedSubObject(Object)	Para obter uma descrição desse membro, confira AddParsedSubObject(Object). (Herdado de Control)
IPostBackEventHandler.RaisePostBackEvent(String)	Para obter uma descrição desse método, consulte RaisePostBackEvent(String).

Métodos de Extensão

EnablePersistedSelection(BaseDataBoundControl)	Obsoleto. Permite que a seleção seja persistida nos controles de dados que dão suporte à seleção e à paginação.
FindDataSourceControl(Control)	Retorna a fonte de dados associada ao controle de dados do controle especificado.
FindFieldTemplate(Control, String)	Retorna o modelo do campo para a coluna especificada no contêiner de nomenclatura do controle especificado.
FindMetaTable(Control)	Retorna o objeto metatable para o controle que contém dados.

Aplica-se a

Partilhar via