DataList 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.

Um controle de lista com limite de dados que exibe itens usando modelos.

public ref class DataList : System::Web::UI::WebControls::BaseDataList, System::Web::UI::INamingContainer, System::Web::UI::WebControls::IRepeatInfoUser

public class DataList : System.Web.UI.WebControls.BaseDataList, System.Web.UI.INamingContainer, System.Web.UI.WebControls.IRepeatInfoUser

[System.Web.UI.ControlValueProperty("SelectedValue")]
public class DataList : System.Web.UI.WebControls.BaseDataList, System.Web.UI.INamingContainer, System.Web.UI.WebControls.IRepeatInfoUser

type DataList = class
    inherit BaseDataList
    interface INamingContainer
    interface IRepeatInfoUser

[<System.Web.UI.ControlValueProperty("SelectedValue")>]
type DataList = class
    inherit BaseDataList
    interface INamingContainer
    interface IRepeatInfoUser

Public Class DataList
Inherits BaseDataList
Implements INamingContainer, IRepeatInfoUser

Herança: Object

Control

WebControl

BaseDataList
DataList

Atributos: ControlValuePropertyAttribute

Implementações: INamingContainer IRepeatInfoUser

Exemplos

O exemplo de código a seguir demonstra como usar um DataList controle para exibir uma lista de itens de uma fonte de dados.

Observação

O exemplo de código a seguir usa o modelo de código de arquivo único e pode não funcionar corretamente se copiado diretamente em um arquivo code-behind. Este exemplo de código deve ser copiado para um arquivo de texto vazio que tenha uma extensão de .aspx. Para obter mais informações sobre o modelo de código do Web Forms, consulte ASP.NET Web Forms Page Code Model.


<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
 
<!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" >
   <script runat="server">
 
      ICollection CreateDataSource() 
      {
      
         // Create sample data for the DataList control.
         DataTable dt = new DataTable();
         DataRow dr;
 
         // Define the columns of the table.
         dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
         dt.Columns.Add(new DataColumn("StringValue", typeof(String)));
         dt.Columns.Add(new DataColumn("CurrencyValue", typeof(double)));
         dt.Columns.Add(new DataColumn("ImageValue", typeof(String)));
 
         // Populate the table with sample values.
         for (int i = 0; i < 9; i++) 
         {
            dr = dt.NewRow();
 
            dr[0] = i;
            dr[1] = "Description for item " + i.ToString();
            dr[2] = 1.23 * (i + 1);
            dr[3] = "Image" + i.ToString() + ".jpg";
 
            dt.Rows.Add(dr);
         }
 
         DataView dv = new DataView(dt);
         return dv;
      }
 
 
      void Page_Load(Object sender, EventArgs e) 
      {

         // Load sample data only once, when the page is first loaded.
         if (!IsPostBack) 
         {
            ItemsList.DataSource = CreateDataSource();
            ItemsList.DataBind();
         }

      }
 
   </script>
 
<head runat="server">
    <title>DataList Example</title>
</head>
<body>
 
   <form id="form1" runat="server">

      <h3>DataList Example</h3>
 
      <asp:DataList id="ItemsList"
           BorderColor="black"
           CellPadding="5"
           CellSpacing="5"
           RepeatDirection="Vertical"
           RepeatLayout="Table"
           RepeatColumns="3"
           runat="server">

         <HeaderStyle BackColor="#aaaadd">
         </HeaderStyle>

         <AlternatingItemStyle BackColor="Gainsboro">
         </AlternatingItemStyle>

         <HeaderTemplate>

            List of items

         </HeaderTemplate>
               
         <ItemTemplate>

            Description: <br />
            <%# DataBinder.Eval(Container.DataItem, "StringValue") %>

            <br />

            Price: <%# DataBinder.Eval(Container.DataItem, "CurrencyValue", "{0:c}") %>

            <br />

            <asp:Image id="ProductImage" AlternateText="Product picture" 
                 ImageUrl='<%# DataBinder.Eval(Container.DataItem, "ImageValue") %>'
                 runat="server"/>

         </ItemTemplate>
 
      </asp:DataList>
 
   </form>
 
</body>
</html>


<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
 
<!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" >
   <script runat="server">
 
      Function CreateDataSource() As ICollection 
      
         ' Create sample data for the DataList control.
         Dim dt As DataTable = New DataTable()
         dim dr As DataRow
 
         ' Define the columns of the table.
         dt.Columns.Add(New DataColumn("IntegerValue", GetType(Int32)))
         dt.Columns.Add(New DataColumn("StringValue", GetType(String)))
         dt.Columns.Add(New DataColumn("CurrencyValue", GetType(Double)))
         dt.Columns.Add(New DataColumn("ImageValue", GetType(String)))
 
         ' Populate the table with sample values.
         Dim i As Integer

         For i = 0 To 8 

            dr = dt.NewRow()
 
            dr(0) = i
            dr(1) = "Description for item " & i.ToString()
            dr(2) = 1.23 * (i + 1)
            dr(3) = "Image" & i.ToString() & ".jpg"
 
            dt.Rows.Add(dr)

         Next i
 
         Dim dv As DataView = New DataView(dt)
         Return dv

      End Function
 
      Sub Page_Load(sender As Object, e As EventArgs) 

         ' Load sample data only once, when the page is first loaded.
         If Not IsPostBack Then 
     
            ItemsList.DataSource = CreateDataSource()
            ItemsList.DataBind()
         
         End If

      End Sub
 
   </script>
 
<head runat="server">
    <title>DataList Example</title>
</head>
<body>
 
   <form id="form1" runat="server">

      <h3>DataList Example</h3>
 
      <asp:DataList id="ItemsList"
           BorderColor="black"
           CellPadding="5"
           CellSpacing="5"
           RepeatDirection="Vertical"
           RepeatLayout="Table"
           RepeatColumns="3"
           runat="server">

         <HeaderStyle BackColor="#aaaadd">
         </HeaderStyle>

         <AlternatingItemStyle BackColor="Gainsboro">
         </AlternatingItemStyle>

         <HeaderTemplate>

            List of items

         </HeaderTemplate>
               
         <ItemTemplate>

            Description: <br />
            <%# DataBinder.Eval(Container.DataItem, "StringValue") %>

            <br />

            Price: <%# DataBinder.Eval(Container.DataItem, "CurrencyValue", "{0:c}") %>

            <br />

            <asp:Image id="ProductImage" AlternateText="Product picture" 
                 ImageUrl='<%# DataBinder.Eval(Container.DataItem, "ImageValue") %>'
                 runat="server"/>

         </ItemTemplate>
 
      </asp:DataList>
 
   </form>
 
</body>
</html>

Comentários

Neste tópico:

Introdução
Modelos
Personalizando a aparência do controle DataList
Direção e layout de exibição
Segurança
Sintaxe declarativa

Introdução

Use o DataList controle para exibir uma lista de associação de dados definida pelo modelo. O DataList controle dá suporte à seleção e edição.

Modelos

O conteúdo do DataList controle pode ser manipulado usando modelos. A tabela a seguir lista os modelos com suporte.

Nome do Modelo	Descrição
AlternatingItemTemplate	Se definido, fornece o conteúdo e o layout para itens alternados no DataList. Se não estiver definido, `ItemTemplate` será usado.
EditItemTemplate	Se definido, fornece o conteúdo e o layout para o item que está sendo editado no momento no DataList. Se não estiver definido, `ItemTemplate` será usado.
FooterTemplate	Se definido, fornece o conteúdo e o layout para a seção de rodapé do DataList. Se não for definida, uma seção de rodapé não será exibida.
HeaderTemplate	Se definido, fornece o conteúdo e o layout para a seção de cabeçalho do DataList. Se não estiver definida, uma seção de cabeçalho não será exibida.
ItemTemplate	Modelo obrigatório que fornece o conteúdo e o layout para itens no DataList.
SelectedItemTemplate	Se definido, fornece o conteúdo e o layout para o item selecionado no momento no DataList. Se não estiver definido, ItemTemplate será usado.
SeparatorTemplate	Se definido, fornece o conteúdo e o layout para o separador entre os itens no DataList. Se não for definido, um separador não será exibido.

No mínimo, o ItemTemplate precisa ser definido para exibir os itens no DataList controle. Modelos adicionais podem ser usados para fornecer uma aparência personalizada ao DataList controle.

Personalizando a aparência do controle DataList

A aparência do DataList controle pode ser personalizada definindo as propriedades de estilo para as diferentes partes do controle. A tabela a seguir lista as diferentes propriedades de estilo.

Propriedade Style	Descrição
AlternatingItemStyle	Especifica o estilo para itens alternados no DataList controle .
EditItemStyle	Especifica o estilo do item que está sendo editado no DataList controle .
FooterStyle	Especifica o estilo do rodapé no DataList controle .
HeaderStyle	Especifica o estilo do cabeçalho no DataList controle .
ItemStyle	Especifica o estilo dos itens no DataList controle .
SelectedItemStyle	Especifica o estilo do item selecionado no DataList controle .
SeparatorStyle	Especifica o estilo do separador entre os itens no DataList controle .

Você também pode mostrar ou ocultar diferentes partes do controle. A tabela a seguir lista as propriedades que controlam quais partes são mostradas ou ocultas.

Propriedade	Descrição
ShowFooter	Mostra ou oculta a seção de rodapé do DataList controle.
ShowHeader	Mostra ou oculta a seção de cabeçalho do DataList controle.

Direção e layout de exibição

A direção de exibição de um DataList controle pode ser vertical ou horizontal. Defina a RepeatDirection propriedade para especificar a direção de exibição.

O layout do DataList controle é controlado com a RepeatLayout propriedade . Definir essa propriedade RepeatLayout.Table como exibirá o DataList em um formato de tabela, enquanto RepeatLayout.Flow exibe o DataList sem uma estrutura de tabela.

Segurança

O DataList controle pode conter controles que permitem que os usuários insiram informações.

Cuidado

Esse controle pode ser usado para exibir a entrada do usuário, que pode incluir script de cliente mal-intencionado. Verifique as informações enviadas de um cliente para script executável, instruções SQL ou outro código antes de exibi-lo em seu aplicativo. Você pode usar controles de validação para verificar a entrada do usuário antes de exibir o texto de entrada em um controle . ASP.NET fornece um recurso de validação de solicitação de entrada para bloquear script e HTML na entrada do usuário.

Para obter mais informações sobre segurança, consulte Protegendo controles padrão, Como proteger contra explorações de script em um aplicativo Web aplicando codificação HTML a cadeias de caracteres e Validando a entrada do usuário em ASP.NET páginas da Web.

Sintaxe declarativa

<asp:DataList  
    AccessKey="string"  
    BackColor="color name|#dddddd"  
    BorderColor="color name|#dddddd"  
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|  
        Inset|Outset"  
    BorderWidth="size"  
    Caption="string"  
    CaptionAlign="NotSet|Top|Bottom|Left|Right"  
    CellPadding="integer"  
    CellSpacing="integer"  
    CssClass="string"  
    DataKeyField="string"  
    DataMember="string"  
    DataSource="string"  
    DataSourceID="string"  
    EditItemIndex="integer"  
    Enabled="True|False"  
    EnableTheming="True|False"  
    EnableViewState="True|False"  
    ExtractTemplateRows="True|False"  
    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"  
    GridLines="None|Horizontal|Vertical|Both"  
    Height="size"  
    HorizontalAlign="NotSet|Left|Center|Right|Justify"  
    ID="string"  
    OnCancelCommand="CancelCommand event handler"  
    OnDataBinding="DataBinding event handler"  
    OnDeleteCommand="DeleteCommand event handler"  
    OnDisposed="Disposed event handler"  
    OnEditCommand="EditCommand event handler"  
    OnInit="Init event handler"  
    OnItemCommand="ItemCommand event handler"  
    OnItemCreated="ItemCreated event handler"  
    OnItemDataBound="ItemDataBound event handler"  
    OnLoad="Load event handler"  
    OnPreRender="PreRender event handler"  
    OnSelectedIndexChanged="SelectedIndexChanged event handler"  
    OnUnload="Unload event handler"  
    OnUpdateCommand="UpdateCommand event handler"  
    RepeatColumns="integer"  
    RepeatDirection="Horizontal|Vertical"  
    RepeatLayout="Table|Flow"  
    runat="server"  
    SelectedIndex="integer"  
    ShowFooter="True|False"  
    ShowHeader="True|False"  
    SkinID="string"  
    Style="string"  
    TabIndex="integer"  
    ToolTip="string"  
    UseAccessibleHeader="True|False"  
    Visible="True|False"  
    Width="size"  
>  
        <AlternatingItemStyle />  
        <AlternatingItemTemplate>  
            <!-- child controls -->  
        </AlternatingItemTemplate>  
        <EditItemStyle />  
        <EditItemTemplate>  
            <!-- child controls -->  
        </EditItemTemplate>  
        <FooterStyle />  
        <FooterTemplate>  
            <!-- child controls -->  
        </FooterTemplate>  
        <HeaderStyle />  
        <HeaderTemplate>  
            <!-- child controls -->  
        </HeaderTemplate>  
        <ItemStyle />  
        <ItemTemplate>  
            <!-- child controls -->  
        </ItemTemplate>  
        <SelectedItemStyle />  
        <SelectedItemTemplate>  
            <!-- child controls -->  
        </SelectedItemTemplate>  
        <SeparatorStyle />  
        <SeparatorTemplate>  
            <!-- child controls -->  
        </SeparatorTemplate>  
</asp:DataList>

Construtores

DataList()

Inicializa uma nova instância da classe DataList.

Campos

CancelCommandName	Representa o nome do comando `Cancel`. Este campo é somente leitura.
DeleteCommandName	Representa o nome do comando `Delete`. Este campo é somente leitura.
EditCommandName	Representa o nome do comando `Edit`. Este campo é somente leitura.
SelectCommandName	Representa o nome do comando `Select`. Este campo é somente leitura.
UpdateCommandName	Representa o nome do comando `Update`. Este campo é somente leitura.

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)
AlternatingItemStyle	Obtém as propriedades de estilo para itens alternados no controle DataList.
AlternatingItemTemplate	Obtém ou define o modelo para alternância de itens na DataList.
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)
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)
Caption	Obtém ou define o texto a ser renderizado em um elemento de legenda HTML no controle. Esta propriedade é fornecida para tornar o controle mais acessível para usuários de dispositivos de tecnologia adaptativa. (Herdado de BaseDataList)
CaptionAlign	Obtém ou define a posição horizontal ou vertical do elemento de legenda HTML em um controle. Esta propriedade é fornecida para tornar o controle mais acessível para usuários de dispositivos de tecnologia adaptativa. (Herdado de BaseDataList)
CellPadding	Obtém ou define a quantidade de espaço entre o conteúdo e a borda de uma célula. (Herdado de BaseDataList)
CellSpacing	Obtém ou define a quantidade de espaço entre células. (Herdado de BaseDataList)
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 um objeto ControlCollection que contém uma coleção de controles filhos em um controle de listagem de dados. (Herdado de BaseDataList)
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)
DataKeyField	Obtém ou define o campo de chave na fonte de dados especificado pela propriedade DataSource. (Herdado de BaseDataList)
DataKeys	Obtém um objeto DataKeyCollection que armazena os valores de chave de cada registro em um controle da lista de dados. (Herdado de BaseDataList)
DataKeysArray	Obtém um objeto ArrayList que contém os valores de chave de cada registro em um controle de listagem de dados. (Herdado de BaseDataList)
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 o membro de dados específico em uma fonte de dados de vários membros a ser associado a um controle de listagem de dados. (Herdado de BaseDataList)
DataSource	Obtém ou define a fonte que contém uma lista de valores usados para popular os itens dentro do controle. (Herdado de BaseDataList)
DataSourceID	Obtém ou define a propriedade ID do controle de fonte de dados que o controle de listagem de dados deve usar para recuperar sua fonte de dados. (Herdado de BaseDataList)
DesignMode	Obtém um valor que indica se um controle está sendo usado em uma superfície de design. (Herdado de Control)
EditItemIndex	Obtém ou define o número de índice do item selecionado no controle DataList a ser editado.
EditItemStyle	Obtém as propriedades de estilo do item selecionado para edição no controle DataList.
EditItemTemplate	Obtém ou define o modelo para o item selecionado para edição no controle DataList.
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)
ExtractTemplateRows	Obtém ou define um valor que indica se as linhas de um controle Table, definidas em cada modelo de um controle DataList, são extraídas e exibidas.
Font	Obtém as propriedades de fonte associadas ao controle do servidor Web. (Herdado de WebControl)
FooterStyle	Obtém as propriedades de estilo da seção de rodapé do controle DataList.
FooterTemplate	Obtém ou define o modelo para a seção de rodapé do controle DataList.
ForeColor	Obtém ou define a cor de primeiro plano (normalmente a cor do texto) do controle de servidor Web. (Herdado de WebControl)
GridLines	Obtém ou define o estilo de linha de grade para o controle DataList quando a propriedade RepeatLayout está definida como `RepeatLayout.Table`.
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)
HeaderStyle	Obtém as propriedades de estilo da seção de cabeçalho do controle DataList.
HeaderTemplate	Obtém ou define o modelo para a seção de cabeçalho do controle DataList.
Height	Obtém ou define a altura do controle do servidor Web. (Herdado de WebControl)
HorizontalAlign	Obtém ou define o alinhamento horizontal de um controle de listagem de dados dentro de seu contêiner. (Herdado de BaseDataList)
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 foi inicializado. (Herdado de BaseDataList)
IsBoundUsingDataSourceID	Obtém um valor que indica se a propriedade DataSourceID foi definida. (Herdado de BaseDataList)
IsChildControlStateCleared	Obtém um valor que indica se os controles contidos dentro deste controle têm estado de controle. (Herdado de Control)
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)
IsViewStateEnabled	Obtém um valor que indica se o estado de exibição está habilitado para esse controle. (Herdado de Control)
Items	Obtém uma coleção de objetos DataListItem que representam os itens individuais no controle.
ItemStyle	Obtém as propriedades de estilo para os itens no controle DataList.
ItemTemplate	Obtém ou define o modelo para os itens no controle DataList.
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)
RepeatColumns	Obtém ou define o número de colunas a serem exibidas no controle DataList.
RepeatDirection	Obtém ou define se o controle DataList é exibido horizontal ou verticalmente.
RepeatLayout	Obtém ou define se o controle é exibido em um layout de fluxo ou tabela.
RequiresDataBinding	Obtém ou define um valor que indica se o controle de listagem de dados precisa se associar à respectiva fonte de dados especificada. (Herdado de BaseDataList)
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 BaseDataList)
SelectedIndex	Obtém ou define o índice do item selecionado no controle DataList.
SelectedItem	Obtém o item selecionado no controle DataList.
SelectedItemStyle	Obtém as propriedades de estilo do item selecionado no controle DataList.
SelectedItemTemplate	Obtém ou define o modelo para o item selecionado no controle DataList.
SelectedValue	Obtém o valor do campo de chave do item de lista de dados selecionado.
SeparatorStyle	Obtém as propriedades de estilo do separador entre cada item no controle DataList.
SeparatorTemplate	Obtém ou define o modelo para o separador entre os itens do controle DataList.
ShowFooter	Obtém ou define um valor que indica se a seção de rodapé é exibida no controle DataList.
ShowHeader	Obtém ou define um valor que indica se a seção de cabeçalho é exibida no controle DataList.
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 BaseDataList)
TabIndex	Obtém ou define o índice de tabulação do controle do servidor Web. (Herdado de WebControl)
TagKey	Obtém a marca HTML usada para renderizar o controle DataList.
TagKey	Obtém o valor HtmlTextWriterTag que corresponde ao controle do servidor Web. Essa propriedade é usada principalmente por desenvolvedores de controle. (Herdado de WebControl)
TagName	Obtém o nome da marca de controle. Essa propriedade é usada principalmente por desenvolvedores de controle. (Herdado de WebControl)
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)
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)
UseAccessibleHeader	Obtém ou define um valor que indica se o controle de listagem de dados renderiza seu cabeçalho em um formato acessível. Esta propriedade é fornecida para tornar o controle mais acessível para usuários de dispositivos de tecnologia adaptativa. (Herdado de BaseDataList)
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)
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 atributos HTML e estilos que precisam ser renderizadas ao HtmlTextWriterTag especificado. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl)
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 do servidor de que um elemento, XML ou HTML, foi analisado e adiciona o elemento à coleção ControlCollection do controle de servidor. (Herdado de BaseDataList)
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)
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()	Cria um controle filho usando o estado de exibição. (Herdado de BaseDataList)
CreateControlCollection()	Cria um novo objeto ControlCollection para manter os controles filho (literal e servidor) do controle do servidor. (Herdado de Control)
CreateControlHierarchy(Boolean)	Cria a hierarquia de controle que é usada para renderizar o controle de lista de dados, com ou sem a fonte de dados especificada.
CreateControlStyle()	Cria o objeto de estilo padrão que é usado internamente pelo controle DataList para implementar todas as propriedades relacionadas ao estilo.
CreateDataSourceSelectArguments()	Cria um objeto DataSourceSelectArguments padrão usado pelo controle associado a dados se nenhum argumento é especificado. (Herdado de BaseDataList)
CreateItem(Int32, ListItemType)	Cria um objeto DataListItem.
DataBind()	Associa o controle e todos os seus controles filho à fonte de dados especificada. (Herdado de BaseDataList)
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()	Verifica se o controle de listagem de dados requer uma associação de dados e se um controle de fonte de dados válido está especificado antes de chamar o método DataBind(). (Herdado de BaseDataList)
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()	Retorna um objeto implementado pelo IEnumerable que representa a fonte de dados. (Herdado de BaseDataList)
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)
InitializeItem(DataListItem)	Inicializa um objeto DataListItem com base nos modelos e estilos especificados para o tipo de item de lista.
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 DataList.
MapPathSecure(String)	Recupera o caminho físico para o qual um caminho virtual é mapeado, relativo ou virtual. (Herdado de Control)
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.
OnCancelCommand(DataListCommandEventArgs)	Aciona o evento CancelCommand. Isso permite que você forneça um manipulador personalizado para o evento.
OnDataBinding(EventArgs)	Aciona o evento DataBinding de um controle BaseDataList. (Herdado de BaseDataList)
OnDataPropertyChanged()	Chamado quando uma das propriedades de identificação da fonte de dados base foi alterada, para associar novamente o controle associado a dados aos seus dados. (Herdado de BaseDataList)
OnDataSourceViewChanged(Object, EventArgs)	Aciona o evento DataSourceViewChanged. (Herdado de BaseDataList)
OnDeleteCommand(DataListCommandEventArgs)	Aciona o evento DeleteCommand. Isso permite que você forneça um manipulador personalizado para o evento.
OnEditCommand(DataListCommandEventArgs)	Aciona o evento EditCommand. Isso permite que você forneça um manipulador personalizado para o evento.
OnInit(EventArgs)	Aciona o evento Init do controle DataList.
OnInit(EventArgs)	Aciona o evento Init do controle BaseDataList. (Herdado de BaseDataList)
OnItemCommand(DataListCommandEventArgs)	Aciona o evento ItemCommand. Isso permite que você forneça um manipulador personalizado para o evento.
OnItemCreated(DataListItemEventArgs)	Aciona o evento ItemCreated. Isso permite que você forneça um manipulador personalizado para o evento.
OnItemDataBound(DataListItemEventArgs)	Aciona o evento ItemDataBound. Isso permite que você forneça um manipulador personalizado para o evento.
OnLoad(EventArgs)	Aciona o evento Load. (Herdado de BaseDataList)
OnPreRender(EventArgs)	Aciona o evento PreRender. (Herdado de BaseDataList)
OnSelectedIndexChanged(EventArgs)	Aciona o evento SelectedIndexChanged de um controle BaseDataList. (Herdado de BaseDataList)
OnUnload(EventArgs)	Aciona o evento Unload. (Herdado de Control)
OnUpdateCommand(DataListCommandEventArgs)	Aciona o evento UpdateCommand. Isso permite que você forneça um manipulador personalizado para o evento.
OpenFile(String)	Obtém um Stream usado para ler um arquivo. (Herdado de Control)
PrepareControlHierarchy()	Prepara a hierarquia de controle para renderização no controle DataList.
RaiseBubbleEvent(Object, EventArgs)	Atribui quaisquer fontes de evento e suas informações para o pai do controle. (Herdado de Control)
RemovedControl(Control)	Chamado após um controle filho ser removido da coleção Controls do objeto Control. (Herdado de Control)
Render(HtmlTextWriter)	Renderiza o controle para o gravador de HTML especificado. (Herdado de BaseDataList)
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)
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 de lista no controle DataList.
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 as alterações no estado de exibição do controle desde a hora em que a página foi postada de volta no servidor.
SetDesignModeState(IDictionary)	Define os dados de tempo de design para um controle. (Herdado de Control)
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()	Controla as alterações de estado de exibição no controle DataList, de modo que elas possam ser armazenadas na propriedade ViewState do controle.

Eventos

CancelCommand	Ocorre quando o botão `Cancel` recebe um clique para um item no controle DataList.
DataBinding	Ocorre quando o controle de servidor é associado a uma fonte de dados. (Herdado de Control)
DeleteCommand	Ocorre quando o botão `Delete` recebe um clique para um item no controle DataList.
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)
EditCommand	Ocorre quando o botão `Edit` recebe um clique para um item no controle DataList.
Init	Ocorre quando o controle de servidor é inicializado, que é a primeira etapa do ciclo de vida. (Herdado de Control)
ItemCommand	Ocorre ao se clicar em qualquer botão no controle DataList.
ItemCreated	Ocorre no servidor quando um item no controle de DataList é criado.
ItemDataBound	Ocorre quando um item tem limite de dados em relação ao controle DataList.
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 um item diferente é selecionado em um controle de lista de dados entre postagens no servidor. (Herdado de BaseDataList)
Unload	Ocorre quando o controle de servidor é descarregado da memória. (Herdado de Control)
UpdateCommand	Ocorre quando o botão `Update` recebe um clique para um item no controle DataList.

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)
IRepeatInfoUser.GetItemStyle(ListItemType, Int32)	Para obter uma descrição desse membro, confira GetItemStyle(ListItemType, Int32).
IRepeatInfoUser.HasFooter	Para obter uma descrição desse membro, confira HasFooter.
IRepeatInfoUser.HasHeader	Para obter uma descrição desse membro, confira HasHeader.
IRepeatInfoUser.HasSeparators	Para obter uma descrição desse membro, confira HasSeparators.
IRepeatInfoUser.RenderItem(ListItemType, Int32, RepeatInfo, HtmlTextWriter)	Para obter uma descrição desse membro, confira RenderItem(ListItemType, Int32, RepeatInfo, HtmlTextWriter).
IRepeatInfoUser.RepeatedItemCount	Para obter uma descrição desse membro, confira RepeatedItemCount.

Métodos de Extensã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.
GetDefaultValues(INamingContainer)	Obtém a coleção de valores padrão para o controle de dados especificado.
GetMetaTable(INamingContainer)	Obtém os metadados de tabela para o controle de dados especificado.
SetMetaTable(INamingContainer, MetaTable)	Define os metadados de tabela para o controle de dados especificado.
SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)	Define os metadados de tabela e o mapeamento de valores padrão para o controle de dados especificado.
SetMetaTable(INamingContainer, MetaTable, Object)	Define os metadados de tabela e o mapeamento de valores padrão para o controle de dados especificado.
TryGetMetaTable(INamingContainer, MetaTable)	Determina se os metadados da tabela estão disponíveis.
EnableDynamicData(INamingContainer, Type)	Habilita o comportamento de Dados Dinâmicos para o controle de dados especificado.
EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)	Habilita o comportamento de Dados Dinâmicos para o controle de dados especificado.
EnableDynamicData(INamingContainer, Type, Object)	Habilita o comportamento de Dados Dinâmicos para o controle de dados especificado.

Aplica-se a

Partilhar via