DataList Classe

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 usando i 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 usare un DataList controllo per visualizzare un elenco di elementi da un'origine dati.

Annotazioni

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
Templates
Personalizzazione dell'aspetto del controllo DataList
Visualizza direzione e layout
sicurezza
Sintassi dichiarativa

Introduzione

Utilizzare 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 usando 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 utilizzato .
EditItemTemplate	Se definito, fornisce il contenuto e il layout per l'elemento attualmente in fase di modifica in DataList. Se non definito, `ItemTemplate` viene utilizzato .
FooterTemplate	Se definito, fornisce il contenuto e il layout per la sezione piè di pagina di DataList. Se non è definita, non verrà visualizzata una sezione piè di pagina.
HeaderTemplate	Se definito, fornisce il contenuto e il layout per la sezione di intestazione di DataList. Se non è definita, 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 utilizzato .
SeparatorTemplate	Se definito, fornisce il contenuto e il layout per il separatore tra gli elementi in DataList. Se non è definito, non verrà visualizzato un separatore.

Al minimo, deve essere definito per ItemTemplate 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 del DataList controllo può essere personalizzato impostando le proprietà di 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 da modificare 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 del separatore tra gli elementi nel DataList controllo .

È anche possibile visualizzare o nascondere parti diverse del controllo. Nella tabella seguente sono elencate le proprietà che controllano le parti 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.

Visualizza direzione e layout

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à . Se si imposta questa proprietà su RepeatLayout.Table verrà visualizzato DataList in un formato di tabella, mentre RepeatLayout.Flow viene visualizzato 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 dell'utente, che potrebbe includere script client dannosi. Controllare le informazioni inviate da un client per lo script eseguibile, le istruzioni SQL o altro codice prima di visualizzarlo nell'applicazione. È possibile usare i controlli di convalida per verificare l'input dell'utente prima di visualizzare il testo di input in un controllo . ASP.NET fornisce una funzionalità di convalida della richiesta di input per bloccare lo script e il codice HTML nell'input dell'utente.

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

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

Nome	Descrizione
DataList()	Inizializza una nuova istanza della classe DataList.

Campi

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

Proprietà

Nome	Descrizione
AccessKey	Ottiene o imposta la chiave di accesso che consente di passare 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 alternati nel DataList controllo .
AlternatingItemTemplate	Ottiene o imposta il modello per gli elementi alternati in DataList.
AppRelativeTemplateSourceDirectory	Ottiene o imposta la directory virtuale relativa all'applicazione dell'oggetto Page o UserControl che contiene questo controllo. (Ereditato da Control)
Attributes	Ottiene la raccolta 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 che contiene il data binding di questo controllo. (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 della didascalia HTML nel controllo . Questa proprietà viene fornita per rendere il controllo più accessibile agli utenti di dispositivi di assistive technology. (Ereditato da BaseDataList)
CaptionAlign	Ottiene o imposta la posizione orizzontale o verticale dell'elemento della didascalia HTML in un controllo . Questa proprietà viene fornita per rendere il controllo più accessibile agli utenti di dispositivi di assistive technology. (Ereditato da BaseDataList)
CellPadding	Ottiene o imposta la quantità di spazio tra il contenuto di una cella e il bordo della cella. (Ereditato da BaseDataList)
CellSpacing	Ottiene o imposta la quantità di spazio tra le celle. (Ereditato da BaseDataList)
ChildControlsCreated	Ottiene un valore che indica se sono stati creati i controlli figlio del controllo server. (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 ClientID proprietà . (Ereditato da Control)
ClientIDSeparator	Ottiene un valore di carattere che rappresenta il carattere separatore utilizzato nella ClientID proprietà . (Ereditato da Control)
Context	Ottiene l'oggetto HttpContext associato al controllo server per la richiesta Web corrente. (Ereditato da Control)
Controls	Ottiene un ControlCollection oggetto che contiene una raccolta di controlli figlio in un controllo elenco dati. (Ereditato da BaseDataList)
ControlStyle	Ottiene lo stile del controllo server Web. Questa proprietà viene utilizzata principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
ControlStyleCreated	Ottiene un valore che indica se è stato creato un Style oggetto per la ControlStyle proprietà . Questa proprietà viene usata principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
CssClass	Ottiene o imposta la classe CSS (Cascading Style Sheet) sottoposta a rendering dal controllo server Web nel 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 dalla DataSource proprietà . (Ereditato da BaseDataList)
DataKeys	Ottiene un DataKeyCollection oggetto che archivia i valori di chiave di ogni record in un controllo elenco dati. (Ereditato da BaseDataList)
DataKeysArray	Ottiene un ArrayList oggetto che contiene i valori chiave di ogni 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 dati specifico in un'origine dati multimember da associare a un controllo elenco dati. (Ereditato da BaseDataList)
DataSource	Ottiene o imposta l'origine contenente un elenco di valori utilizzati per popolare gli elementi all'interno del controllo. (Ereditato da BaseDataList)
DataSourceID	Ottiene o imposta la ID proprietà del controllo origine dati che il controllo elenco dati deve utilizzare per recuperare l'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 DataList controllo da modificare.
EditItemStyle	Ottiene le proprietà di stile per l'elemento selezionato per la modifica nel DataList controllo .
EditItemTemplate	Ottiene o imposta il modello per l'elemento selezionato per la modifica nel DataList controllo .
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 i temi si applicano a questo controllo. (Ereditato da WebControl)
EnableViewState	Ottiene o imposta un valore che indica se il controllo server mantiene lo stato di visualizzazione e lo stato di visualizzazione di tutti i controlli figlio contenuti, al client richiedente. (Ereditato da Control)
Events	Ottiene un elenco di 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 Table controllo, definite in ogni modello di un DataList controllo, vengono estratte e visualizzate.
Font	Ottiene le proprietà del tipo di carattere associate al controllo server Web. (Ereditato da WebControl)
FooterStyle	Ottiene le proprietà di stile per la sezione piè di pagina del DataList controllo .
FooterTemplate	Ottiene o imposta il modello per la sezione piè di pagina del DataList controllo .
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 della linea della griglia per il DataList controllo quando la RepeatLayout proprietà è impostata su `RepeatLayout.Table`.
HasAttributes	Ottiene un valore che indica se il controllo dispone di attributi impostati. (Ereditato da WebControl)
HasChildViewState	Ottiene un valore che indica se i controlli figlio del controllo server corrente hanno impostazioni dello stato di visualizzazione salvate. (Ereditato da Control)
HeaderStyle	Ottiene le proprietà di stile per la sezione intestazione del DataList controllo .
HeaderTemplate	Ottiene o imposta il modello per la sezione dell'intestazione del DataList controllo .
Height	Ottiene o imposta l'altezza del controllo server Web. (Ereditato da WebControl)
HorizontalAlign	Ottiene o imposta l'allineamento orizzontale di un controllo elenco dati all'interno del relativo contenitore. (Ereditato da BaseDataList)
ID	Ottiene o imposta l'identificatore programmatico 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 DataSourceID proprietà è impostata. (Ereditato da BaseDataList)
IsChildControlStateCleared	Ottiene un valore che indica se i controlli contenuti all'interno di questo controllo hanno uno stato di 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 apportate allo stato di visualizzazione. (Ereditato da Control)
IsViewStateEnabled	Ottiene un valore che indica se lo stato di visualizzazione è abilitato per questo controllo. (Ereditato da Control)
Items	Ottiene un insieme di DataListItem oggetti che rappresentano i singoli elementi all'interno del controllo .
ItemStyle	Ottiene le proprietà di stile per gli elementi nel DataList controllo .
ItemTemplate	Ottiene o imposta il modello per gli elementi nel DataList controllo .
LoadViewStateByID	Ottiene un valore che indica se il controllo partecipa al caricamento dello stato di visualizzazione in ID base al posto dell'indice. (Ereditato da Control)
NamingContainer	Ottiene un riferimento al contenitore di denominazione del controllo server, che crea uno spazio dei nomi univoco per la differenziazione tra i controlli server con lo stesso ID valore della proprietà. (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 pagina. (Ereditato da Control)
RenderingCompatibility	Ottiene un valore che specifica la versione ASP.NET con cui è stato eseguito il rendering del codice HTML sarà compatibile. (Ereditato da Control)
RepeatColumns	Ottiene o imposta il numero di colonne da visualizzare nel DataList controllo .
RepeatDirection	Ottiene o imposta un valore che indica se il DataList controllo viene visualizzato verticalmente o orizzontalmente.
RepeatLayout	Ottiene o imposta un valore che indica se il controllo viene visualizzato in una tabella o in un layout di flusso.
RequiresDataBinding	Ottiene o imposta un valore che indica se il controllo elenco dati deve essere associato all'origine dati specificata. (Ereditato da BaseDataList)
SelectArguments	Ottiene un DataSourceSelectArguments oggetto utilizzato dal controllo associato a dati durante il recupero di dati da un controllo origine dati. (Ereditato da BaseDataList)
SelectedIndex	Ottiene o imposta l'indice dell'elemento selezionato nel DataList controllo .
SelectedItem	Ottiene l'elemento selezionato nel DataList controllo .
SelectedItemStyle	Ottiene le proprietà di stile per l'elemento selezionato nel DataList controllo .
SelectedItemTemplate	Ottiene o imposta il modello per l'elemento selezionato nel DataList controllo .
SelectedValue	Ottiene il valore del campo chiave per l'elemento dell'elenco dati selezionato.
SeparatorStyle	Ottiene le proprietà di stile del separatore tra ogni elemento del DataList controllo .
SeparatorTemplate	Ottiene o imposta il modello per il separatore tra gli elementi del DataList controllo.
ShowFooter	Ottiene o imposta un valore che indica se la sezione del piè di pagina viene visualizzata nel DataList controllo .
ShowHeader	Ottiene o imposta un valore che indica se la sezione dell'intestazione viene visualizzata nel DataList controllo .
Site	Ottiene informazioni sul contenitore che ospita il controllo corrente durante il rendering in un'area di progettazione. (Ereditato da Control)
SkinID	Ottiene o imposta l'interfaccia da applicare al controllo. (Ereditato da WebControl)
Style	Ottiene una raccolta di attributi di testo di cui verrà eseguito il rendering come attributo di stile sul tag esterno del controllo server Web. (Ereditato da WebControl)
SupportsDisabledAttribute	Ottiene un valore che indica se il controllo deve impostare l'attributo dell'elemento `disabled` HTML sottoposto a rendering su "disabled" quando la proprietà del IsEnabled controllo è `false`. (Ereditato da BaseDataList)
TabIndex	Ottiene o imposta l'indice della scheda del controllo server Web. (Ereditato da WebControl)
TagKey	Ottiene il tag HTML utilizzato per eseguire il rendering del DataList controllo.
TagKey	Ottiene il HtmlTextWriterTag valore che corrisponde a questo controllo server Web. Questa proprietà viene utilizzata principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
TagName	Ottiene il nome del tag di controllo. Questa proprietà viene utilizzata principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
TemplateControl	Ottiene o imposta un riferimento al modello che contiene questo controllo. (Ereditato da Control)
TemplateSourceDirectory	Ottiene la directory virtuale dell'oggetto Page o UserControl che contiene il controllo server corrente. (Ereditato da Control)
ToolTip	Ottiene o imposta il testo visualizzato quando il puntatore del mouse passa il mouse sul controllo server Web. (Ereditato da WebControl)
UniqueID	Ottiene l'identificatore univoco e qualificato gerarchicamente per il controllo server. (Ereditato da Control)
UseAccessibleHeader	Ottiene o imposta un valore che indica se il controllo elenco dati esegue il rendering dell'intestazione in un formato accessibile. Questa proprietà viene fornita per rendere il controllo più accessibile agli utenti di dispositivi di assistive technology. (Ereditato da BaseDataList)
ValidateRequestMode	Ottiene o imposta un valore che indica se il controllo controlla l'input client dal browser per individuare valori potenzialmente pericolosi. (Ereditato da Control)
ViewState	Ottiene un dizionario di informazioni sullo stato che consente di salvare e ripristinare lo stato di visualizzazione di un controllo server tra più richieste per la stessa pagina. (Ereditato da Control)
ViewStateIgnoresCase	Ottiene un valore che indica se l'oggetto StateBag non fa distinzione tra maiuscole e minuscole. (Ereditato da Control)
ViewStateMode	Ottiene o imposta la modalità dello stato di visualizzazione di questo controllo. (Ereditato da Control)
Visible	Ottiene o imposta un valore che indica se il rendering di un controllo server viene eseguito come interfaccia utente nella pagina. (Ereditato da Control)
Width	Ottiene o imposta la larghezza del controllo server Web. (Ereditato da WebControl)

Metodi

Nome	Descrizione
AddAttributesToRender(HtmlTextWriter)	Aggiunge attributi e stili HTML di cui è necessario eseguire il rendering nell'oggetto specificato HtmlTextWriterTag. Questo metodo viene usato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
AddedControl(Control, Int32)	Chiamato dopo l'aggiunta di un controllo figlio all'insieme 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 alla raccolta del ControlCollection controllo server. (Ereditato da BaseDataList)
ApplyStyle(Style)	Copia tutti gli elementi non in blocchi dello stile specificato nel controllo Web, sovrascrivendo tutti gli elementi di stile esistenti del controllo. Questo metodo viene usato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
ApplyStyleSheetSkin(Page)	Applica le proprietà di stile definite nel foglio di stile della pagina al controllo . (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 distribuisce alla Trace proprietà da visualizzare quando la traccia è abilitata per la pagina. (Ereditato da Control)
ClearCachedClientID()	Imposta il valore memorizzato nella ClientID cache 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 ClientIDMode proprietà 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 da cui viene chiamato questo metodo. Questo metodo viene usato 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 ControlCollection oggetto per contenere i controlli figlio (sia letterali che server) del controllo server. (Ereditato da Control)
CreateControlHierarchy(Boolean)	Crea la gerarchia di controlli utilizzata per eseguire il rendering del controllo elenco dati, con o senza l'origine dati specificata.
CreateControlStyle()	Crea l'oggetto stile predefinito utilizzato internamente dal DataList controllo per implementare tutte le proprietà correlate allo stile.
CreateDataSourceSelectArguments()	Crea un oggetto predefinito DataSourceSelectArguments utilizzato dal controllo associato a dati se non vengono specificati argomenti. (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 richiamato e a tutti i relativi controlli figlio con un'opzione per generare l'evento DataBinding . (Ereditato da Control)
DataBindChildren()	Associa un'origine dati ai controlli figlio del controllo server. (Ereditato da Control)
Dispose()	Consente a un controllo server di eseguire la pulizia finale prima che venga rilasciata 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, crea controlli figlio. (Ereditato da Control)
EnsureDataBound()	Verifica che il controllo elenco dati richieda il data binding e che venga specificato un controllo origine dati valido prima di chiamare il DataBind() metodo . (Ereditato da BaseDataList)
EnsureID()	Crea un identificatore per i controlli a cui non è assegnato un identificatore. (Ereditato da Control)
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
FindControl(String, Int32)	Cerca nel contenitore di denominazione corrente un controllo server con l'oggetto specificato `id` e un numero intero, specificato nel `pathOffset` parametro , che facilita la ricerca. Non è consigliabile eseguire l'override di questa versione del FindControl metodo . (Ereditato da Control)
FindControl(String)	Cerca nel contenitore di denominazione corrente un controllo server con il parametro specificato `id` . (Ereditato da Control)
Focus()	Imposta lo stato attivo dell'input su un controllo . (Ereditato da Control)
GetData()	Restituisce un IEnumerableoggetto implementato da che rappresenta l'origine dati. (Ereditato da BaseDataList)
GetDesignModeState()	Ottiene i dati in fase di progettazione per un controllo . (Ereditato da Control)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetRouteUrl(Object)	Ottiene l'URL che corrisponde a un set di parametri di route. (Ereditato da Control)
GetRouteUrl(RouteValueDictionary)	Ottiene l'URL che corrisponde 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 un nome di route. (Ereditato da Control)
GetRouteUrl(String, RouteValueDictionary)	Ottiene l'URL che corrisponde a un set di parametri di route e un nome di route. (Ereditato da Control)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
GetUniqueIDRelativeTo(Control)	Restituisce la parte con prefisso della UniqueID proprietà 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 per i controlli figlio. (Ereditato da Control)
InitializeItem(DataListItem)	Inizializza un DataListItem oggetto in base ai modelli e agli stili specificati per il tipo di elemento elenco.
IsLiteralContent()	Determina se il controllo server contiene solo contenuto letterale. (Ereditato da Control)
LoadControlState(Object)	Ripristina le informazioni sullo stato del controllo da una richiesta di pagina precedente salvata dal SaveControlState() metodo . (Ereditato da Control)
LoadViewState(Object)	Carica lo stato di visualizzazione salvato in precedenza del DataList controllo.
MapPathSecure(String)	Recupera il percorso fisico a cui viene mappato un percorso virtuale, assoluto o relativo. (Ereditato da Control)
MemberwiseClone()	Crea una copia superficiale dell'oggetto corrente Object. (Ereditato da Object)
MergeStyle(Style)	Copia tutti gli elementi non in blocchi dello stile specificato nel controllo Web, ma non sovrascriverà gli elementi di stile esistenti del controllo. Questo metodo viene usato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
OnBubbleEvent(Object, EventArgs)	Determina se l'evento per il controllo server viene passato alla gerarchia di controllo server dell'interfaccia utente della pagina.
OnCancelCommand(DataListCommandEventArgs)	Genera l'evento CancelCommand. In questo modo è possibile fornire un gestore personalizzato per l'evento.
OnDataBinding(EventArgs)	Genera l'evento DataBinding di un BaseDataList controllo . (Ereditato da BaseDataList)
OnDataPropertyChanged()	Chiamato quando viene modificata una delle proprietà di identificazione dell'origine dati di base per riassociare il controllo associato a dati. (Ereditato da BaseDataList)
OnDataSourceViewChanged(Object, EventArgs)	Genera l'evento DataSourceViewChanged. (Ereditato da BaseDataList)
OnDeleteCommand(DataListCommandEventArgs)	Genera l'evento DeleteCommand. In questo modo è possibile fornire un gestore personalizzato per l'evento.
OnEditCommand(DataListCommandEventArgs)	Genera l'evento EditCommand. In questo modo è possibile fornire un gestore personalizzato per l'evento.
OnInit(EventArgs)	Genera l'evento Init per il DataList controllo .
OnItemCommand(DataListCommandEventArgs)	Genera l'evento ItemCommand. In questo modo è possibile fornire un gestore personalizzato per l'evento.
OnItemCreated(DataListItemEventArgs)	Genera l'evento ItemCreated. In questo modo è possibile fornire un gestore personalizzato per l'evento.
OnItemDataBound(DataListItemEventArgs)	Genera l'evento ItemDataBound. In questo 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 BaseDataList controllo . (Ereditato da BaseDataList)
OnUnload(EventArgs)	Genera l'evento Unload. (Ereditato da Control)
OnUpdateCommand(DataListCommandEventArgs)	Genera l'evento UpdateCommand. In questo modo è possibile fornire un gestore personalizzato per l'evento.
OpenFile(String)	Ottiene un Stream oggetto utilizzato per leggere un file. (Ereditato da Control)
PrepareControlHierarchy()	Prepara la gerarchia dei controlli per il rendering nel DataList controllo .
RaiseBubbleEvent(Object, EventArgs)	Assegna tutte le origini dell'evento e le relative informazioni all'elemento padre del controllo. (Ereditato da Control)
RemovedControl(Control)	Chiamato dopo che un controllo figlio viene rimosso dall'insieme 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 di apertura HTML del controllo nel writer specificato. Questo metodo viene usato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
RenderChildren(HtmlTextWriter)	Restituisce il contenuto degli elementi figlio di un controllo server in un oggetto fornito HtmlTextWriter , che scrive il contenuto di cui eseguire il rendering nel client. (Ereditato da Control)
RenderContents(HtmlTextWriter)	Esegue il rendering degli elementi di elenco nel DataList controllo .
RenderControl(HtmlTextWriter, ControlAdapter)	Restituisce il contenuto del controllo server a un oggetto fornito HtmlTextWriter utilizzando un oggetto fornito ControlAdapter . (Ereditato da Control)
RenderControl(HtmlTextWriter)	Restituisce il contenuto del controllo server in un oggetto fornito HtmlTextWriter e archivia le informazioni di traccia sul controllo se la traccia è abilitata. (Ereditato da Control)
RenderEndTag(HtmlTextWriter)	Esegue il rendering del tag di chiusura HTML del controllo nel writer specificato. Questo metodo viene usato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
ResolveAdapter()	Ottiene l'adattatore di 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 URL utilizzabile nel client richiedente. (Ereditato da Control)
SaveControlState()	Salva le modifiche apportate allo stato del controllo server dopo il postback della pagina al server. (Ereditato da Control)
SaveViewState()	Salva le modifiche apportate allo stato di visualizzazione del controllo dal momento in cui la pagina è stata pubblicata nel server.
SetDesignModeState(IDictionary)	Imposta i dati in 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, Object)	Imposta i dati di traccia per la traccia in fase di progettazione dei dati di rendering, usando l'oggetto tracciato, la chiave dei dati di traccia e il valore dei dati di traccia. (Ereditato da Control)
SetTraceData(Object, Object)	Imposta i dati di traccia per la traccia in fase di progettazione dei dati di rendering, usando 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 modifiche dello stato di visualizzazione al DataList controllo in modo che possano essere archiviate nella proprietà del ViewState controllo.

Eventi

Nome	Descrizione
CancelCommand	Si verifica quando si fa clic sul `Cancel` pulsante per un elemento nel DataList controllo .
DataBinding	Si verifica quando il controllo server viene associato a un'origine dati. (Ereditato da Control)
DeleteCommand	Si verifica quando si fa clic sul `Delete` pulsante per un elemento nel DataList controllo .
Disposed	Si verifica quando viene rilasciato un controllo server dalla memoria, ovvero l'ultima fase del ciclo di vita del controllo server quando viene richiesta una pagina ASP.NET. (Ereditato da Control)
EditCommand	Si verifica quando si fa clic sul `Edit` pulsante per un elemento nel DataList controllo .
Init	Si verifica quando il controllo server viene inizializzato, ovvero il primo passaggio del ciclo di vita. (Ereditato da Control)
ItemCommand	Si verifica quando si fa clic su un pulsante nel DataList controllo .
ItemCreated	Si verifica nel server quando viene creato un elemento nel DataList controllo .
ItemDataBound	Si verifica quando un elemento è associato a dati al DataList controllo .
Load	Si verifica quando il controllo server viene 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 un elemento diverso viene selezionato in un controllo elenco dati tra i post nel server. (Ereditato da BaseDataList)
Unload	Si verifica quando il controllo server viene scaricato dalla memoria. (Ereditato da Control)
UpdateCommand	Si verifica quando si fa clic sul `Update` pulsante per un elemento nel DataList controllo .

Implementazioni dell'interfaccia esplicita

Nome	Descrizione
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 sul 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

Nome	Descrizione
EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)	Abilita il comportamento dei dati dinamici per il controllo dati specificato.
EnableDynamicData(INamingContainer, Type, Object)	Abilita il comportamento dei dati dinamici per il controllo dati specificato.
EnableDynamicData(INamingContainer, Type)	Abilita il comportamento dei dati dinamici per il controllo dati specificato.
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 metatable per il controllo dati contenitore.
GetDefaultValues(INamingContainer)	Ottiene la raccolta dei valori predefiniti per il controllo dati specificato.
GetMetaTable(INamingContainer)	Ottiene i metadati della tabella per il controllo dati specificato.
SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)	Imposta i metadati della tabella e il mapping dei valori predefiniti per il controllo dati specificato.
SetMetaTable(INamingContainer, MetaTable, Object)	Imposta i metadati della tabella e il mapping dei valori predefiniti per il controllo dati specificato.
SetMetaTable(INamingContainer, MetaTable)	Imposta i metadati della tabella per il controllo dati specificato.
TryGetMetaTable(INamingContainer, MetaTable)	Determina se i metadati della tabella sono disponibili.

Si applica a

Vedi anche

Commenti e suggerimenti

Questa pagina è stata utile?