DataList Classe

Definizione

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à
Attributi
Implementazioni

Esempio

Nell'esempio di codice seguente viene illustrato come utilizzare DataList un 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 Web Forms codice, vedere Web Forms ASP.NET Page Code Model.


<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
   <script runat="server">
 
      ICollection CreateDataSource() 
      {
      
         // Create sample data for the DataList control.
         DataTable dt = new DataTable();
         DataRow dr;
 
         // Define the columns of the table.
         dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
         dt.Columns.Add(new DataColumn("StringValue", typeof(String)));
         dt.Columns.Add(new DataColumn("CurrencyValue", typeof(double)));
         dt.Columns.Add(new DataColumn("ImageValue", typeof(String)));
 
         // Populate the table with sample values.
         for (int i = 0; i < 9; i++) 
         {
            dr = dt.NewRow();
 
            dr[0] = i;
            dr[1] = "Description for item " + i.ToString();
            dr[2] = 1.23 * (i + 1);
            dr[3] = "Image" + i.ToString() + ".jpg";
 
            dt.Rows.Add(dr);
         }
 
         DataView dv = new DataView(dt);
         return dv;
      }
 
 
      void Page_Load(Object sender, EventArgs e) 
      {

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

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

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

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

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

         <HeaderTemplate>

            List of items

         </HeaderTemplate>
               
         <ItemTemplate>

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

            <br />

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

            <br />

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

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

<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
   <script runat="server">
 
      Function CreateDataSource() As ICollection 
      
         ' Create sample data for the DataList control.
         Dim dt As DataTable = New DataTable()
         dim dr As DataRow
 
         ' Define the columns of the table.
         dt.Columns.Add(New DataColumn("IntegerValue", GetType(Int32)))
         dt.Columns.Add(New DataColumn("StringValue", GetType(String)))
         dt.Columns.Add(New DataColumn("CurrencyValue", GetType(Double)))
         dt.Columns.Add(New DataColumn("ImageValue", GetType(String)))
 
         ' Populate the table with sample values.
         Dim i As Integer

         For i = 0 To 8 

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

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

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

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

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

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

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

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

         <HeaderTemplate>

            List of items

         </HeaderTemplate>
               
         <ItemTemplate>

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

            <br />

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

            <br />

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

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

Commenti

In questo argomento

Introduzione

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

Modelli

Il contenuto del DataList controllo può essere modificato tramite 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 in fase di modifica in DataList . Se non è definito, ItemTemplate viene usato .
FooterTemplate Se definito, fornisce il contenuto e il layout per la sezione del piè di pagina di DataList . Se non è definito, non verrà visualizzata una sezione del piè di pagina.
HeaderTemplate Se definito, fornisce il contenuto e il layout per la sezione di 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 gli elementi in DataList . Se non è definito, non verrà visualizzato un separatore.

Come minimo, è necessario definire per visualizzare ItemTemplate gli elementi nel controllo DataList . È 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à di stile per le diverse parti del controllo. Nella tabella seguente sono elencate le diverse proprietà di stile.

Proprietà Style 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 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 di intestazione del DataList controllo.

Direzione di visualizzazione 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 proprietà RepeatLayout . L'impostazione di questa RepeatLayout.Table proprietà su visualizzerà DataList l'oggetto in un formato di tabella, mentre visualizza RepeatLayout.Flow senza una struttura di DataList 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 eventuali informazioni inviate da un client per script eseguibili, SQL istruzioni o altro codice prima di visualizzarle 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 una funzionalità di convalida della richiesta di input per bloccare script e HTML nell'input dell'utente.

Per altre informazioni sulla sicurezza, vedere Protezione dei controlli standard, Procedura:Proteggere da exploit di script in un'applicazione Web applicando la codifica HTML alle stringhe e Convalida dell'inpututente in 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

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

Vedi anche