DataList Classe

Riferimento

Definizione

Spazio dei nomi:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Controllo elenco associato a dati che visualizza gli elementi tramite modelli.

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

Ereditarietà: Object

Control

WebControl

BaseDataList
DataList

Attributi: ControlValuePropertyAttribute

Implementazioni: INamingContainer IRepeatInfoUser

Esempio

Nell'esempio di codice seguente viene illustrato come utilizzare un DataList controllo per visualizzare un elenco di elementi da un'origine dati.

Nota

L'esempio di codice seguente usa il modello di codice a file singolo e potrebbe non funzionare correttamente se copiato direttamente in un file code-behind. Questo esempio di codice deve essere copiato in un file di testo vuoto con estensione .aspx. Per altre informazioni sul modello di codice Web Form, vedere ASP.NET modello di codice della pagina Web Form.


<%@ 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>

Commenti

In questo argomento

Introduzione
Modelli
Personalizzazione dell'aspetto del controllo DataList
Direzione e layout di visualizzazione
Sicurezza
Sintassi dichiarativa

Introduzione

Usare il DataList controllo per visualizzare un elenco associato a dati definito dal modello. Il DataList controllo supporta la selezione e la modifica.

Modelli

Il contenuto del DataList controllo può essere modificato utilizzando i modelli. Nella tabella seguente sono elencati i modelli supportati.

Nome modello	Descrizione
AlternatingItemTemplate	Se definito, fornisce il contenuto e il layout per gli elementi alternati in DataList. Se non definito, `ItemTemplate` viene usato.
EditItemTemplate	Se definito, fornisce il contenuto e il layout per l'elemento attualmente modificato nell'oggetto DataList. Se non definito, `ItemTemplate` viene usato.
FooterTemplate	Se definito, fornisce il contenuto e il layout per la sezione piè di pagina di DataList. Se non definito, non verrà visualizzata una sezione piè di pagina.
HeaderTemplate	Se definito, fornisce il contenuto e il layout per la sezione intestazione di DataList. Se non definito, non verrà visualizzata una sezione di intestazione.
ItemTemplate	Modello obbligatorio che fornisce il contenuto e il layout per gli elementi in DataList.
SelectedItemTemplate	Se definito, fornisce il contenuto e il layout per l'elemento attualmente selezionato in DataList. Se non definito, ItemTemplate viene usato.
SeparatorTemplate	Se definito, fornisce il contenuto e il layout per il separatore tra elementi nell'oggetto DataList. Se non definito, non verrà visualizzato un separatore.

Al minimo, è ItemTemplate necessario definire per visualizzare gli elementi nel DataList controllo. È possibile usare modelli aggiuntivi per fornire un aspetto personalizzato al DataList controllo.

Personalizzazione dell'aspetto del controllo DataList

L'aspetto DataList del controllo può essere personalizzato impostando le proprietà dello stile per le diverse parti del controllo. Nella tabella seguente sono elencate le diverse proprietà di stile.

Style, proprietà	Descrizione
AlternatingItemStyle	Specifica lo stile per gli elementi alternati nel DataList controllo.
EditItemStyle	Specifica lo stile per l'elemento modificato nel DataList controllo.
FooterStyle	Specifica lo stile per il piè di pagina nel DataList controllo.
HeaderStyle	Specifica lo stile per l'intestazione nel DataList controllo.
ItemStyle	Specifica lo stile per gli elementi nel DataList controllo.
SelectedItemStyle	Specifica lo stile per l'elemento selezionato nel DataList controllo.
SeparatorStyle	Specifica lo stile per il separatore tra gli elementi del DataList controllo.

È anche possibile visualizzare o nascondere parti diverse del controllo. Nella tabella seguente sono elencate le proprietà che controllano quali parti vengono visualizzate o nascoste.

Proprietà	Descrizione
ShowFooter	Mostra o nasconde la sezione piè di pagina del DataList controllo.
ShowHeader	Mostra o nasconde la sezione intestazione del DataList controllo.

Direzione e layout di visualizzazione

La direzione di visualizzazione di un DataList controllo può essere verticale o orizzontale. Impostare la RepeatDirection proprietà per specificare la direzione di visualizzazione.

Il layout del DataList controllo viene controllato con la RepeatLayout proprietà . Impostando questa proprietà su RepeatLayout.Table verrà visualizzato in un formato di tabella, mentre RepeatLayout.Flow viene visualizzato DataList senza DataList una struttura di tabella.

Sicurezza

Il DataList controllo può contenere controlli che consentono agli utenti di immettere informazioni.

Attenzione

Questo controllo può essere usato per visualizzare l'input utente, che potrebbe includere script client dannosi. Controllare tutte le informazioni inviate da un client per script eseguibili, istruzioni SQL o altro codice prima di visualizzarlo nell'applicazione. È possibile usare i controlli di convalida per verificare l'input utente prima di visualizzare il testo di input in un controllo. ASP.NET fornisce una funzionalità di convalida della richiesta di input per bloccare script e HTML nell'input utente.

Per altre informazioni sulla sicurezza, vedere Protezione dei controlli standard, Procedura: Proteggere dagli exploit di script in un'applicazione Web applicando la codifica HTML alle stringhe e convalidando l'input utente in ASP.NET pagine Web.

Sintassi dichiarativa

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

Costruttori

DataList()

Inizializza una nuova istanza della classe DataList.

Campi

CancelCommandName	Rappresenta il nome di comando `Cancel`. Questo campo è di sola lettura.
DeleteCommandName	Rappresenta il nome di comando `Delete`. Questo campo è di sola lettura.
EditCommandName	Rappresenta il nome di comando `Edit`. Questo campo è di sola lettura.
SelectCommandName	Rappresenta il nome di comando `Select`. Questo campo è di sola lettura.
UpdateCommandName	Rappresenta il nome di comando `Update`. Questo campo è di sola lettura.

Proprietà

AccessKey	Ottiene o imposta il tasto di scelta che consente di accedere rapidamente al controllo server Web. (Ereditato da WebControl)
Adapter	Ottiene l'adattatore specifico del browser per il controllo. (Ereditato da Control)
AlternatingItemStyle	Ottiene le proprietà di stile per gli elementi alternativi del controllo DataList.
AlternatingItemTemplate	Ottiene o imposta il modello per gli elementi alternativi del controllo DataList.
AppRelativeTemplateSourceDirectory	Ottiene o imposta la directory virtuale relativa all'applicazione dell'oggetto Page o UserControl contenente questo controllo. (Ereditato da Control)
Attributes	Ottiene l'insieme di attributi arbitrari (solo per il rendering) che non corrispondono alle proprietà del controllo. (Ereditato da WebControl)
BackColor	Ottiene o imposta il colore di sfondo del controllo server Web. (Ereditato da WebControl)
BindingContainer	Ottiene il controllo contenente l'associazione dati del controllo corrente. (Ereditato da Control)
BorderColor	Ottiene o imposta il colore del bordo del controllo Web. (Ereditato da WebControl)
BorderStyle	Ottiene o imposta lo stile del bordo del controllo server Web. (Ereditato da WebControl)
BorderWidth	Ottiene o imposta la larghezza del bordo del controllo server Web. (Ereditato da WebControl)
Caption	Ottiene o imposta il testo di cui eseguire il rendering in un elemento didascalia HTML nel controllo. Questa proprietà viene fornita per rendere il controllo più accessibile agli utenti di dispositivi che assistono i disabili. (Ereditato da BaseDataList)
CaptionAlign	Ottiene o imposta la posizione orizzontale o verticale dell'elemento didascalia HTML in un controllo. Questa proprietà viene fornita per rendere il controllo più accessibile agli utenti di dispositivi che assistono i disabili. (Ereditato da BaseDataList)
CellPadding	Ottiene o imposta la quantità di spazio tra il contenuto e il bordo di una cella. (Ereditato da BaseDataList)
CellSpacing	Ottiene o imposta la distanza tra le celle. (Ereditato da BaseDataList)
ChildControlsCreated	Ottiene un valore che indica se i controlli figli del controllo server sono stati creati. (Ereditato da Control)
ClientID	Ottiene l'ID di controllo per il markup HTML generato da ASP.NET. (Ereditato da Control)
ClientIDMode	Ottiene o imposta l'algoritmo utilizzato per generare il valore della proprietà ClientID. (Ereditato da Control)
ClientIDSeparator	Ottiene un carattere che rappresenta il separatore utilizzato nella proprietà ClientID. (Ereditato da Control)
Context	Ottiene l'oggetto HttpContext associato al controllo server per la richiesta Web corrente. (Ereditato da Control)
Controls	Ottiene un oggetto ControlCollection contenente un insieme di controlli figlio in un controllo elenco dati. (Ereditato da BaseDataList)
ControlStyle	Ottiene lo stile del controllo server Web. Questa proprietà viene usata principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
ControlStyleCreated	Ottiene un valore che indica se è stato creato un oggetto Style per la proprietà ControlStyle. Questa proprietà viene utilizzata principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
CssClass	Ottiene o imposta la classe CSS (Cascading Style Sheet) di cui viene eseguito il rendering tramite il controllo server Web sul client. (Ereditato da WebControl)
DataItemContainer	Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataItemContainer. (Ereditato da Control)
DataKeyField	Ottiene o imposta il campo chiave nell'origine dati specificata tramite la proprietà DataSource. (Ereditato da BaseDataList)
DataKeys	Ottiene un oggetto DataKeyCollection in cui sono memorizzati i valori chiave di ciascun record in un controllo elenco dati. (Ereditato da BaseDataList)
DataKeysArray	Ottiene un oggetto ArrayList che contiene i valori chiave di ciascun record in un controllo elenco dati. (Ereditato da BaseDataList)
DataKeysContainer	Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataKeysControl. (Ereditato da Control)
DataMember	Ottiene o imposta il membro di dati specifico in un'origine dati costituita da più membri per associarlo a un controllo di elenco dei dati. (Ereditato da BaseDataList)
DataSource	Ottiene o imposta l’origine contenente un elenco di valori utilizzato per inserire gli elementi all’interno del controllo. (Ereditato da BaseDataList)
DataSourceID	Ottiene o imposta la proprietà ID del controllo origine dati che il controllo elenco dati deve utilizzare per recuperare la propria origine dati. (Ereditato da BaseDataList)
DesignMode	Ottiene un valore che indica se un controllo viene utilizzato in un'area di progettazione. (Ereditato da Control)
EditItemIndex	Ottiene o imposta il numero di indice dell'elemento selezionato nel controllo DataList da modificare.
EditItemStyle	Ottiene le proprietà di stile dell'elemento selezionato per la modifica nel controllo DataList.
EditItemTemplate	Ottiene o imposta il modello per l'elemento selezionato per la modifica nel controllo DataList.
Enabled	Ottiene o imposta un valore che indica se il controllo server Web è abilitato. (Ereditato da WebControl)
EnableTheming	Ottiene o imposta un valore che indica se al controllo vengono applicati i temi. (Ereditato da WebControl)
EnableViewState	Ottiene o imposta un valore che indica se lo stato di visualizzazione del controllo server deve essere persistente e lo stato di visualizzazione dei controlli figlio contenuti, per il client richiedente. (Ereditato da Control)
Events	Ottiene un elenco dei delegati del gestore eventi per il controllo. Questa proprietà è di sola lettura. (Ereditato da Control)
ExtractTemplateRows	Ottiene o imposta un valore che indica se le righe di un controllo Table, definite in ciascun modello di un controllo DataList, sono estratte e visualizzate.
Font	Ottiene le proprietà del carattere associate al controllo server Web. (Ereditato da WebControl)
FooterStyle	Ottiene le proprietà di stile per la sezione del piè di pagina del controllo DataList.
FooterTemplate	Ottiene o imposta il modello per la sezione del piè di pagina del controllo DataList.
ForeColor	Ottiene o imposta il colore di primo piano, in genere il colore del testo, del controllo server Web. (Ereditato da WebControl)
GridLines	Ottiene o imposta lo stile delle linee di griglia per il controllo DataList quando la proprietà RepeatLayout è impostata su `RepeatLayout.Table`.
HasAttributes	Ottiene un valore che indica se sono impostati attributi per il controllo. (Ereditato da WebControl)
HasChildViewState	Ottiene un valore che indica se per i controlli figlio del controllo server corrente esistono impostazioni dello stato di visualizzazione salvate. (Ereditato da Control)
HeaderStyle	Ottiene le proprietà di stile per la sezione dell'intestazione del controllo DataList.
HeaderTemplate	Ottiene o imposta il modello per la sezione dell'intestazione del controllo DataList.
Height	Ottiene o imposta l'altezza del controllo server Web. (Ereditato da WebControl)
HorizontalAlign	Ottiene o imposta l’allineamento orizzontale di un controllo di elenco dei dati all'interno del relativo contenitore. (Ereditato da BaseDataList)
ID	Ottiene o imposta l'identificatore a livello di codice assegnato al controllo server. (Ereditato da Control)
IdSeparator	Ottiene il carattere utilizzato per separare gli identificatori di controllo. (Ereditato da Control)
Initialized	Ottiene un valore che indica se il controllo è stato inizializzato. (Ereditato da BaseDataList)
IsBoundUsingDataSourceID	Ottiene un valore che indica se la proprietà DataSourceID è impostata. (Ereditato da BaseDataList)
IsChildControlStateCleared	Ottiene un valore che indica se i controlli contenuti in questo controllo dispongono di informazioni sullo stato del controllo. (Ereditato da Control)
IsEnabled	Ottiene un valore che indica se il controllo è abilitato. (Ereditato da WebControl)
IsTrackingViewState	Ottiene un valore che indica se il controllo server salva le modifiche allo stato di visualizzazione. (Ereditato da Control)
IsViewStateEnabled	Ottiene un valore che indica se lo stato di visualizzazione è attivato per il controllo corrente. (Ereditato da Control)
Items	Ottiene un insieme di oggetti DataListItem che rappresentano i singoli elementi all'interno del controllo.
ItemStyle	Ottiene le proprietà di stile per gli elementi del controllo DataList.
ItemTemplate	Ottiene o imposta il modello per gli elementi del controllo DataList.
LoadViewStateByID	Ottiene un valore che indica se il controllo prende parte al caricamento del proprio stato di visualizzazione tramite ID anziché tramite l'indice. (Ereditato da Control)
NamingContainer	Ottiene un riferimento al contenitore dei nomi del controllo server, che crea uno spazio dei nomi univoco per distinguere i controlli server che hanno lo stesso valore della proprietà ID. (Ereditato da Control)
Page	Ottiene un riferimento all'istanza Page che contiene il controllo server. (Ereditato da Control)
Parent	Ottiene un riferimento al controllo padre del controllo server nella gerarchia dei controlli della pagina. (Ereditato da Control)
RenderingCompatibility	Ottiene un valore che specifica la versione di ASP.NET con cui sarà compatibile il codice HTML di cui è stato eseguito il rendering. (Ereditato da Control)
RepeatColumns	Ottiene o imposta il numero di colonne da visualizzare nel controllo DataList.
RepeatDirection	Ottiene o imposta la visualizzazione in verticale o in orizzontale del controllo DataList.
RepeatLayout	Ottiene o imposta la visualizzazione del controllo sotto forma di tabella o flusso.
RequiresDataBinding	Ottiene o imposta un valore che indica se il controllo elenco dati deve essere associato alla relativa origine dati specificata. (Ereditato da BaseDataList)
SelectArguments	Ottiene un oggetto DataSourceSelectArguments che il controllo con associazione a dati utilizza al momento del recupero dei dati da un controllo origine dati. (Ereditato da BaseDataList)
SelectedIndex	Ottiene o imposta l'indice dell'elemento selezionato nel controllo DataList.
SelectedItem	Ottiene l'elemento selezionato nel controllo DataList.
SelectedItemStyle	Ottiene le proprietà di stile per l'elemento selezionato nel controllo DataList.
SelectedItemTemplate	Ottiene o imposta il modello per l'elemento selezionato nel controllo DataList.
SelectedValue	Ottiene il valore del campo chiave dell'elemento dell'elenco di dati selezionato.
SeparatorStyle	Ottiene le proprietà di stile del separatore tra ciascun elemento del controllo DataList.
SeparatorTemplate	Ottiene o imposta il modello per il separatore tra gli elementi del controllo DataList.
ShowFooter	Ottiene o imposta un valore che indica se la sezione del piè di pagina viene visualizzata nel controllo DataList.
ShowHeader	Ottiene o imposta un valore che indica se la sezione dell'intestazione viene visualizzata nel controllo DataList.
Site	Ottiene informazioni sul contenitore del controllo corrente quando viene eseguito il rendering in un'area di progettazione. (Ereditato da Control)
SkinID	Ottiene o imposta l'interfaccia personalizzata da applicare al controllo. (Ereditato da WebControl)
Style	Ottiene un insieme di attributi di testo di cui verrà eseguito il rendering sotto forma di attributo di stile nel tag esterno del controllo server Web. (Ereditato da WebControl)
SupportsDisabledAttribute	Ottiene un valore che indica se il controllo deve impostare l'attributo `disabled` dell'elemento HTML di cui è stato eseguito il rendering su "disabilitato" quando la proprietà IsEnabled del controllo è `false`. (Ereditato da BaseDataList)
TabIndex	Ottiene o imposta l'indice di tabulazione del controllo server Web. (Ereditato da WebControl)
TagKey	Ottiene il tag HTML utilizzato per il rendering del controllo DataList.
TagKey	Ottiene il valore HtmlTextWriterTag corrispondente al controllo server Web. Questa proprietà viene usata principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
TagName	Ottiene il nome del tag del controllo. Questa proprietà viene usata principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
TemplateControl	Ottiene o imposta un riferimento al modello che contiene il controllo. (Ereditato da Control)
TemplateSourceDirectory	Ottiene la directory virtuale dell'oggetto Page o dell'oggetto UserControl che contiene il controllo server corrente. (Ereditato da Control)
ToolTip	Ottiene o imposta il testo visualizzato quando il puntatore del mouse viene posizionato sul controllo server Web. (Ereditato da WebControl)
UniqueID	Ottiene l'identificatore univoco qualificato gerarchicamente per il controllo server. (Ereditato da Control)
UseAccessibleHeader	Ottiene o imposta un valore che indica se un controllo elenco dati esegue il rendering della propria intestazione in un formato accessibile. Questa proprietà viene fornita per rendere il controllo più accessibile agli utenti di dispositivi che assistono i disabili. (Ereditato da BaseDataList)
ValidateRequestMode	Ottiene o imposta un valore che indica se il controllo verifica la presenza di valori potenzialmente pericolosi nell'input proveniente dal browser. (Ereditato da Control)
ViewState	Ottiene un dizionario di informazioni sullo stato che permette di salvare e ripristinare lo stato di visualizzazione di un controllo server attraverso più richieste per la stessa pagina. (Ereditato da Control)
ViewStateIgnoresCase	Ottiene un valore che indica se l'oggetto StateBag non effettua la distinzione tra maiuscole e minuscole. (Ereditato da Control)
ViewStateMode	Ottiene o imposta la modalità dello stato, visualizzazione di questo controllo. (Ereditato da Control)
Visible	Ottiene o imposta un valore che indica se viene eseguito il rendering di un controllo server come interfaccia utente nella pagina. (Ereditato da Control)
Width	Ottiene o imposta la larghezza del controllo server Web. (Ereditato da WebControl)

Metodi

AddAttributesToRender(HtmlTextWriter)	Aggiunge attributi e stili HTML dei quali è necessario eseguire il rendering nell'oggetto HtmlTextWriterTag specificato. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
AddedControl(Control, Int32)	Chiamato dopo che un controllo figlio viene aggiunto alla raccolta Controls dell'oggetto Control. (Ereditato da Control)
AddParsedSubObject(Object)	Notifica al controllo server che un elemento, XML o HTML, è stato analizzato e aggiunge l'elemento all'insieme ControlCollection del controllo server. (Ereditato da BaseDataList)
ApplyStyle(Style)	Copia tutti gli elementi non vuoti dello stile specificato nel controllo Web, sovrascrivendo eventuali elementi di stile del controllo. Il metodo viene utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
ApplyStyleSheetSkin(Page)	Applica al controllo le proprietà di stile definite nel foglio di stile della pagina. (Ereditato da Control)
BeginRenderTracing(TextWriter, Object)	Inizia la traccia in fase di progettazione dei dati di rendering. (Ereditato da Control)
BuildProfileTree(String, Boolean)	Raccoglie informazioni sul controllo server e le recapita alla proprietà Trace in modo che vengano visualizzate quando è attivata la tracciatura per la pagina. (Ereditato da Control)
ClearCachedClientID()	Imposta il valore memorizzato nella cache ClientID su `null`. (Ereditato da Control)
ClearChildControlState()	Elimina le informazioni sullo stato del controllo per i controlli figlio del controllo server. (Ereditato da Control)
ClearChildState()	Elimina le informazioni sullo stato di visualizzazione e sullo stato del controllo per tutti i controlli figlio del controllo server. (Ereditato da Control)
ClearChildViewState()	Elimina le informazioni sullo stato di visualizzazione per tutti i controlli figlio del controllo server. (Ereditato da Control)
ClearEffectiveClientIDMode()	Imposta la proprietà ClientIDMode dell'istanza del controllo corrente e di tutti i controlli figlio su Inherit. (Ereditato da Control)
CopyBaseAttributes(WebControl)	Copia le proprietà non incapsulate dall'oggetto Style dal controllo server Web specificato al controllo server Web dal quale è stato chiamato il metodo. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
CreateChildControls()	Crea un controllo figlio utilizzando lo stato di visualizzazione. (Ereditato da BaseDataList)
CreateControlCollection()	Crea un nuovo oggetto ControlCollection per contenere i controlli figlio (valore letterale e server) del controllo del server. (Ereditato da Control)
CreateControlHierarchy(Boolean)	Crea la gerarchia dei controlli utilizzata per eseguire il rendering del controllo di elenco dei dati con o senza l'origine dati specificata.
CreateControlStyle()	Crea l'oggetto di stile predefinito utilizzato internamente dal controllo DataList per implementare tutte le proprietà correlate allo stile.
CreateDataSourceSelectArguments()	Crea un oggetto DataSourceSelectArguments predefinito utilizzato dal controllo con associazione a dati se non viene specificato alcun argomento. (Ereditato da BaseDataList)
CreateItem(Int32, ListItemType)	Crea un oggetto DataListItem.
DataBind()	Associa il controllo e tutti i relativi controlli figlio all'origine dati specificata. (Ereditato da BaseDataList)
DataBind(Boolean)	Associa un'origine dati al controllo server chiamato e ai relativi controlli figlio con un'opzione per generare l'evento DataBinding. (Ereditato da Control)
DataBindChildren()	Associa un'origine dati al controllo server e ai relativi controlli figlio. (Ereditato da Control)
Dispose()	Abilita un controllo server alla pulizia finale prima che venga rilasciato dalla memoria. (Ereditato da Control)
EndRenderTracing(TextWriter, Object)	Termina la traccia in fase di progettazione dei dati di rendering. (Ereditato da Control)
EnsureChildControls()	Determina se il controllo server contiene controlli figlio. In caso contrario, li crea. (Ereditato da Control)
EnsureDataBound()	Verifica che il controllo elenco dati richieda l'associazione dati e che sia specificato un controllo origine dati valido prima di chiamare il metodo DataBind(). (Ereditato da BaseDataList)
EnsureID()	Crea un identificatore per i controlli a cui non è assegnato alcun identificatore. (Ereditato da Control)
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
FindControl(String)	Cerca un controllo server nel contenitore dei nomi corrente con il parametro `id` specificato. (Ereditato da Control)
FindControl(String, Int32)	Cerca nel contenitore di denominazione corrente un controllo server con il parametro `id` indicato e un intero, specificato nel parametro `pathOffset`, che agevola la ricerca. Non eseguire l'override di questa versione del metodo FindControl. (Ereditato da Control)
Focus()	Imposta lo stato attivo per l'input su un controllo. (Ereditato da Control)
GetData()	Restituisce un oggetto implementato da IEnumerable che rappresenta l'origine dati. (Ereditato da BaseDataList)
GetDesignModeState()	Ottiene i dati della fase di progettazione per un controllo. (Ereditato da Control)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetRouteUrl(Object)	Ottiene l'URL corrispondente a un set di parametri di route. (Ereditato da Control)
GetRouteUrl(RouteValueDictionary)	Ottiene l'URL corrispondente a un set di parametri di route. (Ereditato da Control)
GetRouteUrl(String, Object)	Ottiene l'URL che corrisponde a un set di parametri di route e a un nome della route. (Ereditato da Control)
GetRouteUrl(String, RouteValueDictionary)	Ottiene l'URL che corrisponde a un set di parametri di route e a un nome della route. (Ereditato da Control)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
GetUniqueIDRelativeTo(Control)	Restituisce la parte con prefisso della proprietà UniqueID del controllo specificato. (Ereditato da Control)
HasControls()	Determina se il controllo server contiene controlli figlio. (Ereditato da Control)
HasEvents()	Restituisce un valore che indica se gli eventi vengono registrati per il controllo o eventuali controlli figlio. (Ereditato da Control)
InitializeItem(DataListItem)	Inizializza un oggetto DataListItem in base ai modelli e agli stili specificati per il tipo di elemento di elenco.
IsLiteralContent()	Determina se il controllo server conserva solo il contenuto literal. (Ereditato da Control)
LoadControlState(Object)	Ripristina le informazioni sullo stato del controllo da una richiesta di pagina precedente salvata dal metodo SaveControlState(). (Ereditato da Control)
LoadViewState(Object)	Carica lo stato di visualizzazione precedentemente salvato del controllo DataList.
MapPathSecure(String)	Recupera il percorso fisico al quale è associato un percorso virtuale, assoluto o relativo. (Ereditato da Control)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
MergeStyle(Style)	Copia tutti gli elementi non vuoti dello stile specificato nel controllo Web, ma non sovrascrive eventuali elementi di stile del controllo. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
OnBubbleEvent(Object, EventArgs)	Determina se l'evento per il controllo server viene passato a un livello superiore nella gerarchia dei controlli server dell'interfaccia utente per la pagina.
OnCancelCommand(DataListCommandEventArgs)	Genera l'evento CancelCommand. In tal modo è possibile fornire un gestore personalizzato per l'evento.
OnDataBinding(EventArgs)	Genera l'evento DataBinding di un controllo BaseDataList, (Ereditato da BaseDataList)
OnDataPropertyChanged()	Viene chiamato quando una delle proprietà di identificazione dell'origine dati di base viene modificata, per riassociare il controllo con associazione a dati ai relativi dati. (Ereditato da BaseDataList)
OnDataSourceViewChanged(Object, EventArgs)	Genera l'evento DataSourceViewChanged. (Ereditato da BaseDataList)
OnDeleteCommand(DataListCommandEventArgs)	Genera l'evento DeleteCommand. In tal modo è possibile fornire un gestore personalizzato per l'evento.
OnEditCommand(DataListCommandEventArgs)	Genera l'evento EditCommand. In tal modo è possibile fornire un gestore personalizzato per l'evento.
OnInit(EventArgs)	Genera l'evento Init per il controllo DataList.
OnInit(EventArgs)	Genera l'evento Init per il controllo BaseDataList. (Ereditato da BaseDataList)
OnItemCommand(DataListCommandEventArgs)	Genera l'evento ItemCommand. In tal modo è possibile fornire un gestore personalizzato per l'evento.
OnItemCreated(DataListItemEventArgs)	Genera l'evento ItemCreated. In tal modo è possibile fornire un gestore personalizzato per l'evento.
OnItemDataBound(DataListItemEventArgs)	Genera l'evento ItemDataBound. In tal modo è possibile fornire un gestore personalizzato per l'evento.
OnLoad(EventArgs)	Genera l'evento Load. (Ereditato da BaseDataList)
OnPreRender(EventArgs)	Genera l'evento PreRender. (Ereditato da BaseDataList)
OnSelectedIndexChanged(EventArgs)	Genera l'evento SelectedIndexChanged di un controllo BaseDataList, (Ereditato da BaseDataList)
OnUnload(EventArgs)	Genera l'evento Unload. (Ereditato da Control)
OnUpdateCommand(DataListCommandEventArgs)	Genera l'evento UpdateCommand. In tal modo è possibile fornire un gestore personalizzato per l'evento.
OpenFile(String)	Ottiene un oggetto Stream utilizzato per leggere un file. (Ereditato da Control)
PrepareControlHierarchy()	Prepara la gerarchia dei controlli per il rendering nel controllo DataList.
RaiseBubbleEvent(Object, EventArgs)	Assegna eventuali origini dell'evento e relative informazioni al controllo padre. (Ereditato da Control)
RemovedControl(Control)	Chiamato dopo che un controllo figlio viene rimosso dalla raccolta Controls dell'oggetto Control. (Ereditato da Control)
Render(HtmlTextWriter)	Esegue il rendering del controllo nel writer HTML specificato. (Ereditato da BaseDataList)
RenderBeginTag(HtmlTextWriter)	Esegue il rendering del tag HTML di apertura del controllo nel writer specificato. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
RenderChildren(HtmlTextWriter)	Restituisce il contenuto degli elementi figlio di un controllo server a un oggetto HtmlTextWriter specificato, che scrive il contenuto di cui eseguire il rendering nel client. (Ereditato da Control)
RenderContents(HtmlTextWriter)	Esegue il rendering degli elementi di elenco nel controllo DataList.
RenderControl(HtmlTextWriter)	Restituisce il contenuto del controllo server a un oggetto HtmlTextWriter specificato e archivia le informazioni di traccia relative al controllo se la funzionalità di traccia è abilitata. (Ereditato da Control)
RenderControl(HtmlTextWriter, ControlAdapter)	Restituisce il contenuto del controllo server a un oggetto HtmlTextWriter specificato utilizzando un oggetto ControlAdapter specificato. (Ereditato da Control)
RenderEndTag(HtmlTextWriter)	Esegue il rendering del tag HTML di chiusura del controllo nel writer specificato. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
ResolveAdapter()	Ottiene l'adattatore del controllo responsabile del rendering del controllo specificato. (Ereditato da Control)
ResolveClientUrl(String)	Ottiene un URL che può essere utilizzato dal browser. (Ereditato da Control)
ResolveUrl(String)	Converte un URL in un formato utilizzabile dal client richiedente. (Ereditato da Control)
SaveControlState()	Salva tutte le modifiche dello stato di un controllo server apportate dopo il postback della pagina nel server. (Ereditato da Control)
SaveViewState()	Salva le modifiche apportate allo stato di visualizzazione del controllo dal momento in cui è stato eseguito il postback della pagina al server.
SetDesignModeState(IDictionary)	Imposta i dati della fase di progettazione per un controllo. (Ereditato da Control)
SetRenderMethodDelegate(RenderMethod)	Assegna un delegato del gestore eventi per eseguire il rendering del controllo server e del relativo contenuto nel controllo padre. (Ereditato da Control)
SetTraceData(Object, Object)	Imposta i dati di traccia per la traccia durante la fase di progettazione dei dati di rendering, utilizzando la chiave dei dati di traccia e il valore dei dati di traccia. (Ereditato da Control)
SetTraceData(Object, Object, Object)	Imposta i dati di traccia per la traccia durante la fase di progettazione dei dati di rendering, utilizzando l'oggetto tracciato, la chiave dei dati di traccia e il valore dei dati di traccia. (Ereditato da Control)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
TrackViewState()	Tiene traccia delle variazioni dello stato di visualizzazione del controllo DataList in modo che possano essere archiviate nella proprietà ViewState del controllo.

Eventi

CancelCommand	Viene generato quando si fa clic sul pulsante `Cancel` per un elemento del controllo DataList.
DataBinding	Viene generato quando il controllo server viene associato a un'origine dati. (Ereditato da Control)
DeleteCommand	Viene generato quando si fa clic sul pulsante `Delete` per un elemento del controllo DataList.
Disposed	Si verifica quando un controllo server viene rilasciato dalla memoria, ossia nell'ultima fase della durata di un controllo server quando viene richiesta una pagina ASP.NET. (Ereditato da Control)
EditCommand	Viene generato quando si fa clic sul pulsante `Edit` per un elemento del controllo DataList.
Init	Viene generato quando il controllo server viene inizializzato, ovvero nella prima fase della sua durata. (Ereditato da Control)
ItemCommand	Si verifica quando si fa clic su un pulsante qualsiasi nel controllo DataList.
ItemCreated	Viene generato sul server quando viene creato un elemento nel controllo DataList.
ItemDataBound	Viene generato quando un elemento viene associato ai dati del controllo DataList.
Load	Viene generato quando il controllo server è caricato nell'oggetto Page. (Ereditato da Control)
PreRender	Si verifica dopo il caricamento dell'oggetto Control ma prima del rendering. (Ereditato da Control)
SelectedIndexChanged	Si verifica quando in un controllo di elenco dei dati viene selezionato un elemento diverso tra gli invii al server. (Ereditato da BaseDataList)
Unload	Viene generato quando il controllo server viene scaricato dalla memoria. (Ereditato da Control)
UpdateCommand	Viene generato quando si fa clic sul pulsante `Update` per un elemento del controllo DataList.

Implementazioni dell'interfaccia esplicita

IAttributeAccessor.GetAttribute(String)	Ottiene un attributo del controllo Web con il nome specificato. (Ereditato da WebControl)
IAttributeAccessor.SetAttribute(String, String)	Imposta un attributo del controllo Web sul nome e il valore specificati. (Ereditato da WebControl)
IControlBuilderAccessor.ControlBuilder	Per una descrizione di questo membro, vedere ControlBuilder. (Ereditato da Control)
IControlDesignerAccessor.GetDesignModeState()	Per una descrizione di questo membro, vedere GetDesignModeState(). (Ereditato da Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Per una descrizione di questo membro, vedere SetDesignModeState(IDictionary). (Ereditato da Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Per una descrizione di questo membro, vedere SetOwnerControl(Control). (Ereditato da Control)
IControlDesignerAccessor.UserData	Per una descrizione di questo membro, vedere UserData. (Ereditato da Control)
IDataBindingsAccessor.DataBindings	Per una descrizione di questo membro, vedere DataBindings. (Ereditato da Control)
IDataBindingsAccessor.HasDataBindings	Per una descrizione di questo membro, vedere HasDataBindings. (Ereditato da Control)
IExpressionsAccessor.Expressions	Per una descrizione di questo membro, vedere Expressions. (Ereditato da Control)
IExpressionsAccessor.HasExpressions	Per una descrizione di questo membro, vedere HasExpressions. (Ereditato da Control)
IParserAccessor.AddParsedSubObject(Object)	Per una descrizione di questo membro, vedere AddParsedSubObject(Object). (Ereditato da Control)
IRepeatInfoUser.GetItemStyle(ListItemType, Int32)	Per una descrizione di questo membro, vedere GetItemStyle(ListItemType, Int32).
IRepeatInfoUser.HasFooter	Per una descrizione di questo membro, vedere HasFooter.
IRepeatInfoUser.HasHeader	Per una descrizione di questo membro, vedere HasHeader.
IRepeatInfoUser.HasSeparators	Per una descrizione di questo membro, vedere HasSeparators.
IRepeatInfoUser.RenderItem(ListItemType, Int32, RepeatInfo, HtmlTextWriter)	Per una descrizione di questo membro, vedere RenderItem(ListItemType, Int32, RepeatInfo, HtmlTextWriter).
IRepeatInfoUser.RepeatedItemCount	Per una descrizione di questo membro, vedere RepeatedItemCount.

Metodi di estensione

FindDataSourceControl(Control)	Restituisce l'origine dati associata al controllo dati per il controllo specificato.
FindFieldTemplate(Control, String)	Restituisce il modello di campo per la colonna specificata nel contenitore di denominazione del controllo specificato.
FindMetaTable(Control)	Restituisce l'oggetto metatabella per il controllo contenitore dei dati.
GetDefaultValues(INamingContainer)	Ottiene l'insieme di valori predefiniti per il controllo dei dati specificato.
GetMetaTable(INamingContainer)	Ottiene i metadati della tabella per il controllo dei dati specificato.
SetMetaTable(INamingContainer, MetaTable)	Imposta i metadati della tabella per il controllo dei dati specificato.
SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)	Imposta il mapping dei valori predefiniti e dei metadati della tabella per il controllo dei dati specificato.
SetMetaTable(INamingContainer, MetaTable, Object)	Imposta il mapping dei valori predefiniti e dei metadati della tabella per il controllo dei dati specificato.
TryGetMetaTable(INamingContainer, MetaTable)	Determina se sono disponibili i metadati della tabella.
EnableDynamicData(INamingContainer, Type)	Abilita il comportamento dati dinamici per il controllo dei dati specificato.
EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)	Abilita il comportamento dati dinamici per il controllo dei dati specificato.
EnableDynamicData(INamingContainer, Type, Object)	Abilita il comportamento dati dinamici per il controllo dei dati specificato.

Si applica a

Condividi tramite