BulletedList Classe

Definição

Espaço de Nomes:
System.Web.UI.WebControls
Assemblagem:
System.Web.dll

Cria um controlo que gera uma lista de itens num formato com tópicos.

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 controlo com itens de lista formatados como botões de ligação. O segundo exemplo de código demonstra como criar um BulletedList controlo usando data binding para especificar os itens da lista.

O exemplo de código seguinte demonstra como criar um BulletedList controlo com itens de lista formatados como botões de ligação. O texto é exibido num Label controlo quando um item da 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 seguinte demonstra como criar um BulletedList controlo usando data binding para especificar os itens da lista. Os itens da lista estão formatados como botões de ligação. O texto é exibido num Label controlo quando um item da 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>

Observações

Neste tópico:

Introduction

Use o BulletedList controlo para criar uma lista de itens formatados com tópicos. Para especificar os itens individuais da lista que quer que apareçam num BulletedList controlo, coloque um ListItem objeto para cada entrada entre as etiquetas de abertura e fecho do BulletedList controlo.

Para especificar o tipo de ponto a usar para mostrar itens de lista num BulletedList controlo, defina a BulletStyle propriedade para um dos tipos de pontos definidos pela BulletStyle enumeração. A tabela seguinte lista os estilos de balas disponíveis.

Estilo de bala Description
NotSet Não está definido.
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 preenchido.
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 dos itens da lista num controlo ordenado BulletedList . O valor atribuído à FirstBulletNumber propriedade é ignorado se a BulletStyle propriedade for definida para , DiscSquare, Circle, ou CustomImage campo. Se definir a BulletStyle propriedade para o valor de CustomImage para especificar uma imagem personalizada para o tópico, deve definir a BulletImageUrl propriedade também para especificar a localização do ficheiro da imagem.

Para especificar o comportamento de exibição dos itens da lista num BulletedList, defina a DisplayMode propriedade para um dos valores definidos pela BulletedListDisplayMode enumeração. Os comportamentos de exibição definidos são Text, HyperLink, e LinkButton.

Quando um hiperlink é clicado, ele navega para um URL. Use a Value propriedade para especificar a URL para onde um hyperlink navega. Use a Target propriedade para especificar o frame ou janela que mostra a página Web para a qual se navega quando um hiperlink é clicado.

Quando a DisplayMode propriedade está definida para LinkButton, o BulletedList controlo apresenta os itens da lista como ligações que são publicadas de volta para o servidor ao serem clicadas. Para controlar programaticamente as ações realizadas quando um botão de ligação é clicado, forneça um gestor de eventos para o Click evento. Note-se que as SelectedIndex propriedades e SelectedItem são herdadas da ListControl classe e não são aplicáveis ao BulletedList controlo. Use os dados do evento da BulletedListEventArgs classe para determinar o índice do botão link num BulletedList botão que foi clicado.

O controlo BulletedList também suporta ligação de dados. Para ligar a BulletedList uma fonte de dados, pode usar qualquer um dos mecanismos de ligação de dados fornecidos. Para mais informações, veja Vinculação a Bases de Dados.

Accessibility

A marcação apresentada por defeito para este controlo pode não estar em conformidade com normas de acessibilidade, como as diretrizes de prioridade 1 da Web Content Accessibility Guidelines 1.0 (WCAG). Para detalhes sobre o suporte de acessibilidade para este controlo, consulte ASP.NET Controlos 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

Name Description
BulletedList()

Inicializa uma nova instância da BulletedList classe.

Propriedades

Name Description
AccessKey

Obtém ou define a chave de acesso que permite navegar rapidamente até ao controlo do servidor Web.

(Herdado de WebControl)
Adapter

Recebe o adaptador específico do navegador para o controlo.

(Herdado de Control)
AppendDataBoundItems

Recebe ou define um valor que indica se os itens da lista são eliminados antes da ligação de dados.

(Herdado de ListControl)
AppRelativeTemplateSourceDirectory

Obtém ou define o diretório virtual relativo à aplicação do Page objeto ou UserControl que contém este controlo.

(Herdado de Control)
Attributes

Obtém a coleção de atributos arbitrários (apenas para renderização) que não correspondem a propriedades no controlo.

(Herdado de WebControl)
AutoPostBack

Obtém ou define o valor da AutoPostBack propriedade para a classe base.
BackColor

Obtém ou define a cor de fundo do controlo do servidor Web.

(Herdado de WebControl)
BindingContainer

Obtém o controlo que contém a ligação de dados desse controlo.

(Herdado de Control)
BorderColor

Obtém ou define a cor da borda do controlo Web.

(Herdado de WebControl)
BorderStyle

Obtém ou define o estilo de borda do controlo do servidor Web.

(Herdado de WebControl)
BorderWidth

Obtém ou define a largura da fronteira do controlo do servidor Web.

(Herdado de WebControl)
BulletImageUrl

Obtém ou define o caminho para uma imagem a mostrar para cada bala num BulletedList controlo.
BulletStyle

Recebe ou define o estilo bullet para o BulletedList controlo.
CausesValidation

Recebe ou define um valor que indica se a validação é realizada quando um controlo derivado da ListControl classe é clicado.

(Herdado de ListControl)
ChildControlsCreated

Recebe um valor que indica se os controlos filhos do controlo do servidor foram criados.

(Herdado de Control)
ClientID

Obtém o ID de controlo para a marcação HTML gerada pelo ASP.NET.

(Herdado de Control)
ClientIDMode

Obtém ou define o algoritmo que é usado para gerar o valor da ClientID propriedade.

(Herdado de Control)
ClientIDSeparator

Obtém um valor de carácter que representa o carácter separador usado na ClientID propriedade.

(Herdado de Control)
Context

Obtém o controlo do HttpContext objeto associado ao servidor para o pedido Web atual.

(Herdado de Control)
Controls

Recebe uma ControlCollection cobrança pelo controlo.
ControlStyle

Recebe o estilo do controlo do servidor Web. Esta propriedade é utilizada principalmente por promotores de controlo.

(Herdado de WebControl)
ControlStyleCreated

Recebe um valor que indica se um Style objeto foi criado para a ControlStyle propriedade. Esta propriedade é utilizada principalmente por promotores de controlo.

(Herdado de WebControl)
CssClass

Obtém ou define a classe Cascading Style Sheet (CSS) renderizada pelo controlo do servidor Web no cliente.

(Herdado de WebControl)
DataItemContainer

Obtém uma referência ao contentor de nomes se o contentor implementar IDataItemContainer.

(Herdado de Control)
DataKeysContainer

Obtém uma referência ao contentor de nomes se o contentor implementar IDataKeysControl.

(Herdado de Control)
DataSourceID

Obtém ou define o ID do controlo do qual o controlo limitado por dados recupera a sua lista de itens de dados.

(Herdado de DataBoundControl)
DataSourceObject

Recebe um objeto que implementa a IDataSource interface, que dá 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 textual dos itens da lista.

(Herdado de ListControl)
DataTextFormatString

Obtém ou define a cadeia de formatação usada para controlar como os dados atribuídos ao controlo da 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 da lista.

(Herdado de ListControl)
DesignMode

Obtém um valor que indica se um controlo está a ser usado numa superfície de projeto.

(Herdado de Control)
DisplayMode

Obtém ou define o modo de exibição do conteúdo da lista num BulletedList controlo.
Enabled

Recebe ou define um valor que indica se o controlo do servidor Web está ativado.

(Herdado de WebControl)
EnableTheming

Recebe ou define um valor que indica se os temas se aplicam a este controlo.

(Herdado de WebControl)
EnableViewState

Recebe ou define um valor que indica se o controlo do servidor mantém o seu estado de visualização, e o estado de vista de quaisquer controlos filhos que contém, para o cliente solicitante.

(Herdado de Control)
Events

Obtém uma lista de delegados handler de eventos para o controlo. Esta propriedade é somente leitura.

(Herdado de Control)
FirstBulletNumber

Obtém ou define o valor que inicia a numeração dos itens de lista num controlo ordenado BulletedList .
Font

Obtém as propriedades da fonte associadas ao controlo do servidor Web.

(Herdado de WebControl)
ForeColor

Obtém ou define a cor do primeiro plano (tipicamente a cor do texto) do controlo do servidor Web.

(Herdado de WebControl)
HasAttributes

Recebe um valor que indica se o controlo tem atributos definidos.

(Herdado de WebControl)
HasChildViewState

Recebe um valor que indica se os controlos filhos do controlo atual do servidor têm alguma configuração de estado de visualização guardada.

(Herdado de Control)
Height

Obtém ou define a altura do controlo do servidor Web.

(Herdado de WebControl)
ID

Obtém ou define o identificador programático atribuído ao controlo do servidor.

(Herdado de Control)
IdSeparator

Faz com que o carácter seja usado para separar identificadores de controlo.

(Herdado de Control)
Initialized

Obtém um valor que indica se o controlo ligado a dados foi inicializado.

(Herdado de BaseDataBoundControl)
IsBoundUsingDataSourceID

Recebe um valor que indica se a DataSourceID propriedade está definida.

(Herdado de BaseDataBoundControl)
IsChildControlStateCleared

Obtém um valor que indica se os controlos contidos neste controlo têm estado de controlo.

(Herdado de Control)
IsDataBindingAutomatic

Obtém um valor que indica se a ligação de dados é automática.

(Herdado de BaseDataBoundControl)
IsEnabled

Recebe um valor que indica se o controlo está ativado.

(Herdado de WebControl)
IsTrackingViewState

Recebe um valor que indica se o controlo do servidor está a guardar alterações ao estado de visualização.

(Herdado de Control)
IsUsingModelBinders

Obtém um valor que indica se a binding do modelo está em uso.

(Herdado de DataBoundControl)
IsViewStateEnabled

Recebe um valor que indica se o estado de visualização está ativado para este controlo.

(Herdado de Control)
Items

Obtém o controlo da coleção de itens na lista.

(Herdado de ListControl)
ItemType

Obtém ou define o nome do tipo de elemento de dados para ligação de dados fortemente tipada.

(Herdado de DataBoundControl)
LoadViewStateByID

Recebe um valor que indica se o controlo participa no carregamento do seu estado de visualização em ID vez de index.

(Herdado de Control)
NamingContainer

Obtém uma referência ao contentor de nomes do controlo do servidor, que cria um namespace único para diferenciar controlos de servidor com o mesmo ID valor de propriedade.

(Herdado de Control)
Page

Obtém uma referência à Page instância que contém o controlo do servidor.

(Herdado de Control)
Parent

Obtém uma referência ao controlo pai do controlo do servidor na hierarquia de controlo de página.

(Herdado de Control)
RenderingCompatibility

Recebe um valor que especifica a versão ASP.NET com a qual o HTML renderizado será compatível.

(Herdado de Control)
RenderWhenDataEmpty

Recebe ou define um valor que indica se o controlo é renderizado se a fonte de dados não tiver dados ou se o controlo não estiver ligado a dados.
RequiresDataBinding

Recebe ou define um valor que indica se o DataBind() método deve ser chamado.

(Herdado de BaseDataBoundControl)
SelectArguments

Obtém um DataSourceSelectArguments objeto que o controlo data-bound usa ao recuperar dados de um controlo de fonte de dados.

(Herdado de DataBoundControl)
SelectedIndex

Obtém ou define o índice baseado em zero do item atualmente selecionado num BulletedList controlo.
SelectedItem

Recebe o item atualmente selecionado num BulletedList controlo.
SelectedValue

Obtém ou define a Value propriedade do objeto selecionado ListItem no BulletedList controlo.
SelectMethod

O nome do método a chamar para ler dados.

(Herdado de DataBoundControl)
Site

Obtém informação sobre o contentor que aloja o controlo atual quando renderizado numa superfície de design.

(Herdado de Control)
SkinID

Obtém ou fixa a pele para aplicar no controlo.

(Herdado de WebControl)
Style

Recebe uma coleção de atributos de texto que serão renderizados como um atributo de estilo na etiqueta externa do controlo do servidor Web.

(Herdado de WebControl)
SupportsDisabledAttribute

Obtém um valor que indica se o controlo deve definir o disabled atributo do elemento HTML renderizado como "desabilitado" quando a propriedade do IsEnabled controlo é false.

(Herdado de BaseDataBoundControl)
TabIndex

Obtém ou define o índice de tabulação do controlo do servidor Web.

(Herdado de WebControl)
TagKey

Obtém o HtmlTextWriterTag valor do controlo especificado BulletedList .
TagName

Recebe o nome da etiqueta de controlo. Esta propriedade é utilizada principalmente por promotores de controlo.

(Herdado de WebControl)
Target

Obtém ou define a janela ou frame-alvo onde mostrar o conteúdo da página Web ao qual é ligado quando um hyperlink num BulletedList controlo é clicado.
TemplateControl

Recebe ou define uma referência ao template que contém esse controlo.

(Herdado de Control)
TemplateSourceDirectory

Obtém o diretório virtual do Page ou UserControl que contém o controlo atual do servidor.

(Herdado de Control)
Text

Recebe ou define o texto para o BulletedList controlo.
ToolTip

Obtém ou define o texto exibido quando o ponteiro do rato paira sobre o controlo do servidor Web.

(Herdado de WebControl)
UniqueID

Obtém o identificador único e hierarquicamente qualificado para o controlo do servidor.

(Herdado de Control)
ValidateRequestMode

Recebe ou define um valor que indica se o controlo verifica a entrada do cliente do navegador para valores potencialmente perigosos.

(Herdado de Control)
ValidationGroup

Obtém ou define o grupo de controlos para os quais o controlo derivado da ListControl classe causa validação quando é enviado de volta ao servidor.

(Herdado de ListControl)
ViewState

Obtém um dicionário de informação de estado que permite guardar e restaurar o estado de visualização de um controlo de servidor através de múltiplos pedidos para a mesma página.

(Herdado de Control)
ViewStateIgnoresCase

Obtém um valor que indica se o StateBag objeto é indistinto a maiúsculas e maiúsculas.

(Herdado de Control)
ViewStateMode

Obtém ou define o modo view-state deste controlo.

(Herdado de Control)
Visible

Recebe ou define um valor que indica se um controlo de servidor é renderizado como UI na página.

(Herdado de Control)
Width

Obtém ou define a largura do controlo do servidor Web.

(Herdado de WebControl)

Métodos

Name Description
AddAttributesToRender(HtmlTextWriter)

Adiciona os atributos e estilos HTML para que um BulletedList controlo seja renderizado no objeto especificado.HtmlTextWriter
AddedControl(Control, Int32)

Chamado após um controlo filho ser adicionado à Controls coleção do Control objeto.

(Herdado de Control)
AddParsedSubObject(Object)

Notifica o controlo do servidor que um elemento, seja XML ou HTML, foi analisado, e adiciona o elemento ao objeto do ControlCollection controlo do servidor.

(Herdado de Control)
ApplyStyle(Style)

Copia quaisquer elementos não em branco do estilo especificado para o controlo Web, sobrescrevendo quaisquer elementos de estilo existentes do controlo. Este método é usado principalmente por desenvolvedores de controlo.

(Herdado de WebControl)
ApplyStyleSheetSkin(Page)

Aplica as propriedades de estilo definidas na folha de estilo da página ao controlo.

(Herdado de Control)
BeginRenderTracing(TextWriter, Object)

Inicia o rastreio em tempo de design dos dados de renderização.

(Herdado de Control)
BuildProfileTree(String, Boolean)

Recolhe informações sobre o controlo do servidor e entrega-as à Trace propriedade para serem exibidas quando o rastreamento for ativado para a página.

(Herdado de Control)
ClearCachedClientID()

Define o valor em ClientID cache para null.

(Herdado de Control)
ClearChildControlState()

Apaga a informação de estado de controlo dos controlos filhos do controlo do servidor.

(Herdado de Control)
ClearChildState()

Apaga a informação de view-state e control-state de todos os controlos filhos do servidor.

(Herdado de Control)
ClearChildViewState()

Elimina a informação de estado de visualização de todos os controlos filhos do controlo do servidor.

(Herdado de Control)
ClearEffectiveClientIDMode()

Define a ClientIDMode propriedade da instância de controlo atual e de qualquer controlo filho para Inherit.

(Herdado de Control)
ClearSelection()

Limpa a seleção da lista e define a Selected propriedade de todos os itens para falso.

(Herdado de ListControl)
ConfirmInitState()

Define o estado inicializado do controlo ligado a dados.

(Herdado de BaseDataBoundControl)
CopyBaseAttributes(WebControl)

Copia as propriedades não encapsuladas pelo Style objeto do controlo do servidor Web especificado para o controlo do servidor Web de onde este método é chamado. Este método é utilizado principalmente por reveladores de controlo.

(Herdado de WebControl)
CreateChildControls()

Chamada pelo framework de páginas ASP.NET para notificar os controlos de servidor que utilizam implementação baseada em composição para criar quaisquer controlos filhos que contenham em preparação para publicação ou renderização.

(Herdado de Control)
CreateControlCollection()

Cria um novo ControlCollection objeto para armazenar os controlos filhos (tanto literais como de servidor) do controlo do servidor.

(Herdado de Control)
CreateControlStyle()

Cria o objeto de estilo que é usado internamente pela WebControl classe para implementar todas as propriedades relacionadas com o estilo. Este método é utilizado principalmente por reveladores de controlo.

(Herdado de WebControl)
CreateDataSourceSelectArguments()

Cria um objeto padrão DataSourceSelectArguments usado pelo controlo data-bound se não forem especificados argumentos.

(Herdado de DataBoundControl)
DataBind()

Vincula uma fonte de dados ao controlo do servidor invocado e a todos os seus controlos filhos.

(Herdado de BaseDataBoundControl)
DataBind(Boolean)

Vincula uma fonte de dados ao controlo do servidor invocado e a todos os seus controlos filhos com uma opção para elevar o DataBinding evento.

(Herdado de Control)
DataBindChildren()

Vincula uma fonte de dados aos controlos filhos do controlo do servidor.

(Herdado de Control)
Dispose()

Permite que o controlo do servidor realize a limpeza final antes de ser libertado da memória.

(Herdado de Control)
EndRenderTracing(TextWriter, Object)

Termina o rastreio de tempo de design dos dados de renderização.

(Herdado de Control)
EnsureChildControls()

Determina se o controlo do servidor contém controlos filhos. Se não o fizer, cria controlos filhos.

(Herdado de Control)
EnsureDataBound()

Chama o DataBind() método se a DataSourceID propriedade estiver definida e o controlo data-bound estiver marcado para exigir ligação.

(Herdado de BaseDataBoundControl)
EnsureID()

Cria um identificador para controlos 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, Int32)

Pesquisa no contentor de nomenclatura atual um controlo de servidor com o especificado id e um inteiro, especificados no pathOffset parâmetro, o que auxilia na pesquisa. Não deve sobrepor-se a esta versão do FindControl método.

(Herdado de Control)
FindControl(String)

Procura no contentor de nomenclatura atual um controlo de servidor com o parâmetro especificado id .

(Herdado de Control)
Focus()

Define o foco de entrada num controlo.

(Herdado de Control)
GetData()

Recupera um DataSourceView objeto que o controlo data-bound utiliza para realizar operações de dados.

(Herdado de DataBoundControl)
GetDataSource()

Recupera a IDataSource interface à qual o controlo de dados está associado, se existir.

(Herdado de DataBoundControl)
GetDesignModeState()

Obtém dados de tempo de projeto para um controlo.

(Herdado de Control)
GetHashCode()

Serve como função de hash predefinida.

(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 o URL que corresponde a um conjunto de parâmetros de rota e a um nome de rota.

(Herdado de Control)
GetRouteUrl(String, RouteValueDictionary)

Obtém o URL que corresponde a um conjunto de parâmetros de rota e a um nome de rota.

(Herdado de Control)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
GetUniqueIDRelativeTo(Control)

Devolve a parte prefixada da UniqueID propriedade do controlo especificado.

(Herdado de Control)
HasControls()

Determina se o controlo do servidor contém algum controlo filho.

(Herdado de Control)
HasEvents()

Devolve um valor que indica se os eventos estão registados para o controlo ou para quaisquer controlos filhos.

(Herdado de Control)
IsLiteralContent()

Determina se o controlo do servidor contém apenas conteúdo literal.

(Herdado de Control)
LoadControlState(Object)

Restaura a informação do estado de controlo a partir de um pedido de página anterior que foi guardado pelo SaveControlState() método.

(Herdado de Control)
LoadViewState(Object)

Carrega o estado de visualização previamente guardado do DetailsView controlo.

(Herdado de ListControl)
MapPathSecure(String)

Recupera o caminho físico para o qual um caminho virtual, seja absoluto ou relativo, mapeia.

(Herdado de Control)
MarkAsDataBound()

Define o estado do controlo no estado de visualização como vinculado com sucesso aos dados.

(Herdado de DataBoundControl)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
MergeStyle(Style)

Copia quaisquer elementos não em branco do estilo especificado para o controlo Web, mas não sobrescreve quaisquer elementos de estilo existentes do controlo. Este método é utilizado principalmente por reveladores de controlo.

(Herdado de WebControl)
OnBubbleEvent(Object, EventArgs)

Determina se o evento para o controlo do servidor é passado para a hierarquia de controlo do servidor UI da página.

(Herdado de Control)
OnClick(BulletedListEventArgs)

Aumenta o Click evento para o BulletedList controlo.
OnCreatingModelDataSource(CreatingModelDataSourceEventArgs)

Eleva o CreatingModelDataSource evento.

(Herdado de DataBoundControl)
OnDataBinding(EventArgs)

Eleva o DataBinding evento.

(Herdado de ListControl)
OnDataBound(EventArgs)

Eleva o DataBound evento.

(Herdado de BaseDataBoundControl)
OnDataPropertyChanged()

Volta a vincular o controlo ligado aos dados aos seus dados após uma das propriedades de identificação da fonte base de dados alterar.

(Herdado de DataBoundControl)
OnDataSourceViewChanged(Object, EventArgs)

Eleva o DataSourceViewChanged evento.

(Herdado de DataBoundControl)
OnInit(EventArgs)

Trata do Init evento.

(Herdado de BaseDataBoundControl)
OnLoad(EventArgs)

Trata do Load evento.

(Herdado de DataBoundControl)
OnPagePreLoad(Object, EventArgs)

Define o estado inicializado do controlo ligado a dados antes de este ser carregado.

(Herdado de DataBoundControl)
OnPreRender(EventArgs)

Eleva o PreRender evento.

(Herdado de ListControl)
OnSelectedIndexChanged(EventArgs)

Eleva o SelectedIndexChanged evento. Isto permite-lhe fornecer um handler personalizado para o evento.

(Herdado de ListControl)
OnTextChanged(EventArgs)

Eleva o TextChanged evento.

(Herdado de ListControl)
OnUnload(EventArgs)

Eleva o Unload evento.

(Herdado de Control)
OpenFile(String)

Recebe um Stream usado para ler um ficheiro.

(Herdado de Control)
PerformDataBinding(IEnumerable)

Vincula a fonte de dados especificada ao controlo que é derivado da ListControl classe.

(Herdado de ListControl)
PerformSelect()

Recupera dados da fonte de dados associada.

(Herdado de ListControl)
RaiseBubbleEvent(Object, EventArgs)

Atribui quaisquer fontes do evento e da sua informação ao pai do controlo.

(Herdado de Control)
RaisePostBackEvent(String)

Abre eventos para o BulletedList controlo quando um formulário é devolvido ao servidor.
RemovedControl(Control)

Chamado após um controlo filho ser removido da Controls coleção do Control objeto.

(Herdado de Control)
Render(HtmlTextWriter)

Escreve o BulletedList conteúdo de controlo no objeto especificado HtmlTextWriter para exibição no cliente.
RenderBeginTag(HtmlTextWriter)

Renderiza a etiqueta de abertura HTML do controlo ao escritor especificado. Este método é utilizado principalmente por reveladores de controlo.

(Herdado de WebControl)
RenderBulletText(ListItem, Int32, HtmlTextWriter)

Renderiza o texto em tópicos de cada item da lista num BulletedList controlo.
RenderChildren(HtmlTextWriter)

Exporta o conteúdo dos filhos de um controlo de servidor para um objeto fornecido HtmlTextWriter , que escreve o conteúdo a ser renderizado no cliente.

(Herdado de Control)
RenderContents(HtmlTextWriter)

Apresenta os itens da lista de um BulletedList controlo como balas no especificado HtmlTextWriter.
RenderControl(HtmlTextWriter, ControlAdapter)

Fornece conteúdo de controlo do servidor para um objeto fornecido HtmlTextWriter usando um objeto fornecido ControlAdapter .

(Herdado de Control)
RenderControl(HtmlTextWriter)

Fornece conteúdo de controlo do servidor para um objeto fornecido HtmlTextWriter e armazena informação de rastreamento sobre o controlo se o rastreio estiver ativado.

(Herdado de Control)
RenderEndTag(HtmlTextWriter)

Renderiza a etiqueta HTML de fecho do controlo no escritor especificado. Este método é utilizado principalmente por reveladores de controlo.

(Herdado de WebControl)
ResolveAdapter()

Faz com que o adaptador de controlo seja responsável por renderizar o controlo especificado.

(Herdado de Control)
ResolveClientUrl(String)

Recebe um URL que pode ser usado pelo navegador.

(Herdado de Control)
ResolveUrl(String)

Converte uma URL numa que seja utilizável no cliente solicitante.

(Herdado de Control)
SaveControlState()

Guarda quaisquer alterações no estado de controlo do servidor que tenham ocorrido desde que a página foi publicada de volta no servidor.

(Herdado de Control)
SaveViewState()

Guarda o estado atual da vista do ListControl controlo -derived e dos itens que contém.

(Herdado de ListControl)
SetDesignModeState(IDictionary)

Define dados em tempo de projeto para um controlo.

(Herdado de Control)
SetPostDataSelection(Int32)

Define a Selected propriedade de um ListItem controlo depois de uma página ser publicada.

(Herdado de ListControl)
SetRenderMethodDelegate(RenderMethod)

Atribui um delegado handler de eventos para renderizar o controlo do servidor e o seu conteúdo no controlo pai.

(Herdado de Control)
SetTraceData(Object, Object, Object)

Define os dados de rastreio para o rastreio em tempo de design dos dados de renderização, usando o objeto rastreado, a chave de dados de traço e o valor dos dados de traço.

(Herdado de Control)
SetTraceData(Object, Object)

Define os dados de rastreio para o rastreio em tempo de design dos dados de renderização, usando a chave de dados de traço e o valor dos dados de traço.

(Herdado de Control)
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)
TrackViewState()

Marca o ponto de partida para começar a registar e guardar alterações de estado de vista num ListControl controlo -derived.

(Herdado de ListControl)
ValidateDataSource(Object)

Verifica se o objeto ao qual um controlo databound se liga é um com o qual pode trabalhar.

(Herdado de DataBoundControl)
VerifyMultiSelect()

Determina se o controlo de lista suporta o modo multiseleção.

(Herdado de ListControl)

evento

Name Description
CallingDataMethods

Ocorre quando métodos de dados estão a ser chamados.

(Herdado de DataBoundControl)
Click

Ocorre quando um botão de ligação num BulletedList controlo é clicado.
CreatingModelDataSource

Ocorre quando o ModelDataSource objeto está a ser criado.

(Herdado de DataBoundControl)
DataBinding

Ocorre quando o controlo do servidor se liga a uma fonte de dados.

(Herdado de Control)
DataBound

Ocorre depois de o controlo do servidor se ligar a uma fonte de dados.

(Herdado de BaseDataBoundControl)
Disposed

Ocorre quando um controlo de servidor é libertado da memória, que é a última etapa do ciclo de vida do controlo do servidor quando uma página ASP.NET é solicitada.

(Herdado de Control)
Init

Ocorre quando o controlo do servidor é inicializado, que é o primeiro passo no seu ciclo de vida.

(Herdado de Control)
Load

Ocorre quando o controlo do servidor é carregado no Page objeto.

(Herdado de Control)
PreRender

Ocorre depois do carregamento do Control objeto, mas antes da renderização.

(Herdado de Control)
SelectedIndexChanged

Ocorre quando a seleção do controlo da lista muda entre publicações para o servidor.

(Herdado de ListControl)
TextChanged

Ocorre quando as Text propriedades e SelectedValue mudam.

(Herdado de ListControl)
Unload

Ocorre quando o controlo do servidor é descarregado da memória.

(Herdado de Control)

Implementações de Interface Explícita

Name Description
IAttributeAccessor.GetAttribute(String)

Recebe um atributo do controlo Web com o nome especificado.

(Herdado de WebControl)
IAttributeAccessor.SetAttribute(String, String)

Define um atributo do controlo Web ao nome e valor especificados.

(Herdado de WebControl)
IControlBuilderAccessor.ControlBuilder

Para uma descrição deste elemento, veja ControlBuilder.

(Herdado de Control)
IControlDesignerAccessor.GetDesignModeState()

Para uma descrição deste elemento, veja GetDesignModeState().

(Herdado de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Para uma descrição deste elemento, veja SetDesignModeState(IDictionary).

(Herdado de Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Para uma descrição deste elemento, veja SetOwnerControl(Control).

(Herdado de Control)
IControlDesignerAccessor.UserData

Para uma descrição deste elemento, veja UserData.

(Herdado de Control)
IDataBindingsAccessor.DataBindings

Para uma descrição deste elemento, veja DataBindings.

(Herdado de Control)
IDataBindingsAccessor.HasDataBindings

Para uma descrição deste elemento, veja HasDataBindings.

(Herdado de Control)
IExpressionsAccessor.Expressions

Para uma descrição deste elemento, veja Expressions.

(Herdado de Control)
IExpressionsAccessor.HasExpressions

Para uma descrição deste elemento, veja HasExpressions.

(Herdado de Control)
IParserAccessor.AddParsedSubObject(Object)

Para uma descrição deste elemento, veja AddParsedSubObject(Object).

(Herdado de Control)
IPostBackEventHandler.RaisePostBackEvent(String)

Para uma descrição deste método, veja RaisePostBackEvent(String).

Métodos da Extensão

Name Description
EnablePersistedSelection(BaseDataBoundControl)
Obsoleto.

Permite que a seleção seja mantida em controlos de dados que suportam a seleção e a paginação.
FindDataSourceControl(Control)

Devolve a fonte de dados associada ao controlo de dados para o controlo especificado.
FindFieldTemplate(Control, String)

Devolve o modelo de campo para a coluna especificada no contentor de nomenclatura do controlo especificado.
FindMetaTable(Control)

Devolve o objeto metatable para o controlo de dados que contém.

Aplica-se a

Ver também