Classe ListView (System.Web.UI.WebControls)

Cambia visualizzazione:

ScriptFree

Riferimento a .NET Framework

Classe ListView

Il presente articolo è stato tradotto manualmente. Per visualizzare questa pagina e contemporaneamente visualizzarne il contenuto in lingua inglese, passare alla visualizzazione semplificata.

Visualizza i valori di un'origine dati utilizzando modelli definiti dall'utente. Il controllo ListView consente agli utenti di selezionare, ordinare, eliminare, modificare e inserire record.

Gerarchia di ereditarietà

System.Object
  System.Web.UI.Control
    System.Web.UI.WebControls.WebControl
      System.Web.UI.WebControls.BaseDataBoundControl
        System.Web.UI.WebControls.DataBoundControl
          System.Web.UI.WebControls.ListView

Spazio dei nomi: System.Web.UI.WebControls
Assembly: System.Web.Extensions (in System.Web.Extensions.dll)

Sintassi

Visual Basic

<ControlValuePropertyAttribute("SelectedValue")> _
<ToolboxBitmapAttribute(GetType(ListView), "ListView.bmp")> _
Public Class ListView _
	Inherits DataBoundControl _
	Implements INamingContainer, IPageableItemContainer, IPersistedSelector, IDataKeysControl,  _
	IDataBoundListControl, IDataBoundControl

[ControlValuePropertyAttribute("SelectedValue")]
[ToolboxBitmapAttribute(typeof(ListView), "ListView.bmp")]
public class ListView : DataBoundControl, INamingContainer, 
	IPageableItemContainer, IPersistedSelector, IDataKeysControl, IDataBoundListControl, IDataBoundControl

Visual C++

[ControlValuePropertyAttribute(L"SelectedValue")]
[ToolboxBitmapAttribute(typeof(ListView), L"ListView.bmp")]
public ref class ListView : public DataBoundControl, 
	INamingContainer, IPageableItemContainer, IPersistedSelector, IDataKeysControl, IDataBoundListControl, 
	IDataBoundControl

[<ControlValuePropertyAttribute("SelectedValue")>]
[<ToolboxBitmapAttribute(typeof(ListView), "ListView.bmp")>]
type ListView =  
    class
        inherit DataBoundControl
        interface INamingContainer
        interface IPageableItemContainer
        interface IPersistedSelector
        interface IDataKeysControl
        interface IDataBoundListControl
        interface IDataBoundControl
    end

ASP.NET

<asp:ListView />

Il tipo ListView espone i seguenti membri.

Costruttori

	Nome	Descrizione
	ListView	Inizializza una nuova istanza della classe ListView.

In alto

Proprietà

	Nome	Descrizione
	AccessKey	Esegue l'override della proprietà WebControl.AccessKey. L'impostazione di questa proprietà non è supportata dal controllo ListView. (Esegue l'override di WebControl.AccessKey).
	Adapter	Ottiene l'adattatore specifico del browser per il controllo. (Ereditato da Control)
	AlternatingItemTemplate	Ottiene o imposta il contenuto personalizzato dell'elemento dati alternato in un controllo ListView.
	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	Esegue l'override della proprietà WebControl.BackColor. L'impostazione di questa proprietà non è supportata dal controllo ListView. (Esegue l'override di WebControl.BackColor).
	BindingContainer	Infrastruttura. Ottiene il controllo contenente l'associazione dati del controllo corrente. (Ereditato da Control)
	BorderColor	Esegue l'override della proprietà WebControl.BorderColor. L'impostazione di questa proprietà non è supportata dal controllo ListView. (Esegue l'override di WebControl.BorderColor).
	BorderStyle	Esegue l'override della proprietà WebControl.BorderStyle. L'impostazione di questa proprietà non è supportata dal controllo ListView. (Esegue l'override di WebControl.BorderStyle).
	BorderWidth	Esegue l'override della proprietà WebControl.BorderWidth. L'impostazione di questa proprietà non è supportata dal controllo ListView. (Esegue l'override di WebControl.BorderWidth).
	ChildControlsCreated	Ottiene un valore che indica se i controlli figli del controllo server sono stati creati. (Ereditato da Control)
	ClientID	Ottiene l'ID 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)
	ClientIDRowSuffix	Ottiene o imposta il nome del campo dati il cui valore viene utilizzato per identificare in modo univoco ogni riga di dati di un controllo ListView quando la proprietà ClientIDMode è impostata su Predictable.
	ClientIDRowSuffixDataKeys	Infrastruttura. Ottiene i valori dei dati utilizzati per identificare in modo univoco ogni istanza di un controllo associato a dati quando ASP.NET genera il valore ClientID.
	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 che rappresenta i controlli figlio del controllo ListView. (Esegue l'override di Control.Controls).
	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 oggetto Style per la proprietà ControlStyle. Questa proprietà viene utilizzata principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
	ConvertEmptyStringToNull	Ottiene o imposta un valore che indica se i valori di stringa vuota ("") vengono convertiti automaticamente in valori null quando il campo dati viene aggiornato nell'origine dati.
	CssClass	Esegue l'override della proprietà WebControl.CssClass. L'impostazione di questa proprietà non è supportata dal controllo ListView. (Esegue l'override di WebControl.CssClass).
	DataItemContainer	Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataItemContainer. (Ereditato da Control)
	DataKeyNames	Ottiene o imposta una matrice contenente i nomi dei campi di chiave primaria degli elementi visualizzati in un controllo ListView.
	DataKeys	Ottiene un insieme di oggetti DataKey che rappresentano il valore della chiave di dati di ciascun elemento in un controllo ListView.
	DataKeysContainer	Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataKeysControl. (Ereditato da Control)
	DataMember	Ottiene o imposta il nome dell'elenco di dati a cui si associa il controllo con associazione a dati, nei casi in cui l'origine dati contenga più elenchi distinti di elementi di dati. (Ereditato da DataBoundControl)
	DataSource	Ottiene o imposta l'oggetto da cui il controllo con associazione a dati recupera il relativo elenco degli elementi di dati. (Ereditato da BaseDataBoundControl)
	DataSourceID	Ottiene o imposta l'ID del controllo da cui il controllo con associazione a dati recupera l'elenco degli elementi di dati. (Ereditato da DataBoundControl)
	DataSourceObject	Ottiene un oggetto che implementa l'interfaccia IDataSource che fornisce l'accesso al contenuto dati dell'oggetto. (Ereditato da DataBoundControl)
	DesignMode	Ottiene un valore che indica se un controllo viene utilizzato in un'area di progettazione. (Ereditato da Control)
	EditIndex	Ottiene o imposta l'indice dell'elemento da modificare.
	EditItem	Ottiene l'elemento in modalità di modifica in un controllo ListView.
	EditItemTemplate	Ottiene o imposta il contenuto personalizzato per l'elemento in modalità di modifica.
	EmptyDataTemplate	Ottiene o imposta il contenuto definito dall'utente per il modello vuoto di cui viene eseguito il rendering quando un controllo ListView è associato a un'origine dati che non contiene record.
	EmptyItemTemplate	Ottiene o imposta il contenuto definito dall'utente per l'elemento vuoto di cui viene eseguito il rendering in un controllo ListView quando non sono disponibili altri elementi di dati da visualizzare nell'ultima riga della pagina di dati corrente.
	Enabled	Ottiene o imposta un valore che indica se il controllo server Web è abilitato. (Ereditato da WebControl)
	EnableModelValidation	Ottiene o imposta un valore che indica se un controllo validator gestirà le eccezioni che si verificano durante le operazioni di inserimento o aggiornamento.
	EnablePersistedSelection	Ottiene o imposta un valore che indica se la selezione della riga resta memorizzata quando un utente si sposta tra i dati in un controllo associato a dati.
	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 il controllo server conserva il proprio stato di visualizzazione e lo stato di visualizzazione dei controlli figlio in esso contenuti per il client richiedente. (Ereditato da Control)
	Events	Ottiene un elenco dei delegati del gestore eventi per il controllo. Questa proprietà è in sola lettura. (Ereditato da Control)
	Font	Esegue l'override della proprietà WebControl.Font. Questa proprietà non è supportata dal controllo ListView. (Esegue l'override di WebControl.Font).
	ForeColor	Esegue l'override della proprietà WebControl.ForeColor. L'impostazione di questa proprietà non è supportata dal controllo ListView. (Esegue l'override di WebControl.ForeColor).
	GroupItemCount	Ottiene o imposta il numero di elementi da visualizzare per gruppo in un controllo ListView.
	GroupPlaceholderID	Ottiene o imposta l'ID del segnaposto del gruppo in un controllo ListView.
	GroupSeparatorTemplate	Ottiene o imposta il contenuto definito dall'utente per il separatore tra gruppi in un controllo ListView.
	GroupTemplate	Ottiene o imposta il contenuto definito dall'utente per il contenitore di gruppi in un controllo ListView.
	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)
	Height	Esegue l'override della proprietà WebControl.Height. L'impostazione di questa proprietà non è supportata dal controllo ListView. (Esegue l'override di WebControl.Height).
	ID	Ottiene o imposta l'identificatore a livello di codice assegnato al controllo server. (Ereditato da Control)
	IdSeparator	Infrastruttura. Ottiene il carattere utilizzato per separare gli identificatori di controllo. (Ereditato da Control)
	Initialized	Ottiene un valore che indica se il controllo con associazione a dati è stato inizializzato. (Ereditato da BaseDataBoundControl)
	InsertItem	Ottiene l'elemento di inserimento di un controllo ListView.
	InsertItemPosition	Ottiene o imposta il percorso del modello InsertItemTemplate quando viene sottoposto a rendering come parte del controllo ListView.
	InsertItemTemplate	Ottiene o imposta il contenuto personalizzato per un elemento di inserimento nel controllo ListView.
	IsBoundUsingDataSourceID	Ottiene un valore che indica se la proprietà DataSourceID è impostata. (Ereditato da BaseDataBoundControl)
	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)
	ItemPlaceholderID	Ottiene o imposta l'ID del segnaposto dell'elemento in un controllo ListView.
	Items	Ottiene un insieme di oggetti ListViewDataItem che rappresentano gli elementi dati della pagina di dati corrente in un controllo ListView.
	ItemSeparatorTemplate	Ottiene o imposta il contenuto personalizzato per il separatore tra gli elementi di un controllo ListView.
	ItemTemplate	Ottiene o imposta il contenuto personalizzato per l'elemento dati in un controllo ListView.
	LayoutTemplate	Ottiene o imposta il contenuto personalizzato per il contenitore radice in un controllo ListView.
	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)
	MaximumRows	Ottiene il numero massimo di elementi da visualizzare in una singola pagina del controllo ListView.
	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à Control.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)
	RequiresDataBinding	Ottiene o imposta un valore che indica se deve essere chiamato il metodo DataBind. (Ereditato da BaseDataBoundControl)
	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 DataBoundControl)
	SelectedDataKey	Ottiene il valore della chiave di dati per l'elemento selezionato in un controllo ListView.
	SelectedIndex	Ottiene o imposta l'indice dell'elemento selezionato in un controllo ListView.
	SelectedItemTemplate	Ottiene o imposta il contenuto personalizzato per l'elemento selezionato in un controllo ListView.
	SelectedPersistedDataKey	Ottiene o imposta il valore della chiave di dati per l'elemento persistente selezionato in un controllo associato a dati.
	SelectedValue	Ottiene il valore della chiave di dati dell'elemento selezionato in un controllo ListView.
	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 da applicare al controllo. (Ereditato da WebControl)
	SortDirection	Ottiene la direzione di ordinamento del campo o dei campi da ordinare.
	SortExpression	Ottiene l'espressione di ordinamento associata al campo o ai campi da ordinare.
	StartRowIndex	Ottiene l'indice del primo record visualizzato in una pagina di dati nel controllo ListView.
	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 BaseDataBoundControl)
	TabIndex	Esegue l'override della proprietà WebControl.TabIndex. L'impostazione di questa proprietà non è supportata dal controllo ListView. (Esegue l'override di WebControl.TabIndex).
	TagKey	Ottiene il valore HtmlTextWriterTag corrispondente a questo controllo server Web. Questa proprietà viene utilizzata principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
	TagName	Ottiene il nome del tag del controllo. Questa proprietà viene utilizzata 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	Esegue l'override della proprietà WebControl.ToolTip. L'impostazione di questa proprietà non è supportata dal controllo ListView. (Esegue l'override di WebControl.ToolTip).
	UniqueID	Ottiene l'identificatore univoco qualificato gerarchicamente per il controllo server. (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 un controllo server viene visualizzato come interfaccia utente sulla pagina. (Ereditato da Control)
	Width	Esegue l'override della proprietà WebControl.Width. L'impostazione di questa proprietà non è supportata dal controllo ListView. (Esegue l'override di WebControl.Width).

In alto

Metodi

	Nome	Descrizione
	AddAttributesToRender	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)
	AddControlToContainer	Aggiunge il controllo specificato al contenitore specificato.
	AddedControl	Viene chiamato dopo che un controllo è stato aggiunto all'insieme Controls dell'oggetto Control. (Ereditato da Control)
	AddParsedSubObject	Notifica al controllo server che un elemento, XML o HTML, è stato analizzato e aggiunge l'elemento all'oggetto ControlCollection del controllo server. (Ereditato da Control)
	ApplyStyle	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	Applica al controllo le proprietà di stile definite nel foglio di stile della pagina. (Ereditato da Control)
	BuildProfileTree	Infrastruttura. 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	Infrastruttura. 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	Infrastruttura. Imposta la proprietà ClientIDMode dell'istanza del controllo corrente e di tutti i controlli figlio su Inherit. (Ereditato da Control)
	ConfirmInitState	Imposta lo stato inizializzato del controllo con associazione a dati. (Ereditato da BaseDataBoundControl)
	CopyBaseAttributes	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 la gerarchia dei controlli utilizzata per eseguire il rendering del controllo ListView in base ai valori archiviati nello stato di visualizzazione. (Esegue l'override di Control.CreateChildControls()).
	CreateChildControls(IEnumerable, Boolean)	Crea la gerarchia dei controlli utilizzata per eseguire il rendering del controllo ListView utilizzando l'origine dati specificata.
	CreateControlCollection	Crea un nuovo oggetto ControlCollection per contenere i controlli figlio (letterali e server) del controllo server. (Ereditato da Control)
	CreateControlStyle	Crea lo stile predefinito per il controllo. (Esegue l'override di WebControl.CreateControlStyle()).
	CreateDataItem	Crea un elemento dati nel controllo ListView.
	CreateDataSourceSelectArguments	Crea l'oggetto DataSourceSelectArguments contenente gli argomenti che vengono passati all'origine dati. (Esegue l'override di DataBoundControl.CreateDataSourceSelectArguments()).
	CreateEmptyDataItem	Crea il modello EmptyDataTemplate nel controllo ListView.
	CreateEmptyItem	Crea un elemento vuoto nel controllo ListView.
	CreateInsertItem	Crea un elemento di inserimento nel controllo ListView.
	CreateItem	Crea un oggetto ListViewItem con il tipo specificato.
	CreateItemsInGroups	Crea la gerarchia dei controlli ListView nei gruppi.
	CreateItemsWithoutGroups	Crea la gerarchia dei controlli ListView senza gruppi.
	CreateLayoutTemplate	Crea il contenitore radice nel controllo ListView.
	CreateSuffixArrayList	Infrastruttura. Crea una matrice di suffissi per ASP.NET da utilizzare quando viene generato il valore ClientID.
	DataBind()	Associa un'origine dati al controllo server richiamato e a tutti i relativi controlli figlio. (Ereditato da BaseDataBoundControl)
	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)
	DeleteItem	Elimina dall'origine dati il record in corrispondenza dell'indice specificato.
	Dispose	Abilita un controllo server alla pulizia finale prima che venga rilasciato dalla memoria. (Ereditato da Control)
	EnsureChildControls	Determina se il controllo server contiene controlli figlio. In caso contrario, li crea. (Ereditato da Control)
	EnsureDataBound	Chiama il metodo DataBind se la proprietà DataSourceID è impostata e il controllo con associazione a dati è contrassegnato per la richiesta dell'associazione. (Ereditato da BaseDataBoundControl)
	EnsureID	Crea un identificatore per i controlli a cui non è assegnato alcun identificatore. (Ereditato da Control)
	EnsureLayoutTemplate	Assicura che il contenuto LayoutTemplate sia creato correttamente nel controllo ListView.
	Equals(Object)	Determina se l'oggetto Object specificato è uguale all'oggetto Object corrente. (Ereditato da Object)
	ExtractItemValues	Recupera i valori di tutti i campi dichiarati nell'elemento specificato e li archivia nell'oggetto IOrderedDictionary specificato.
	Finalize	Consente a un oggetto di provare a liberare risorse ed eseguire altre operazioni di pulitura prima che l'oggetto stesso venga recuperato dalla procedura di Garbage Collection. (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)	Infrastruttura. 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)
	FindPlaceholder	Cerca un controllo con l'identificatore specificato nel contenitore specificato.
	Focus	Imposta lo stato attivo per l'input su un controllo. (Ereditato da Control)
	GetData	Recupera un oggetto DataSourceView che il controllo con associazione a dati utilizza per eseguire le operazioni relative ai dati. (Ereditato da DataBoundControl)
	GetDataSource	Recupera l'interfaccia IDataSource a cui è associato il controllo con associazione a dati, se presente. (Ereditato da DataBoundControl)
	GetDesignModeState	Infrastruttura. Ottiene i dati della fase di progettazione per un controllo. (Ereditato da Control)
	GetHashCode	Funge da funzione hash per un determinato tipo. (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	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)
	InsertNewItem	Inserisce il record corrente nell'origine dati.
	InstantiateEmptyDataTemplate	Popola l'oggetto Control specificato utilizzando i controlli figlio contenuti nel modello EmptyDataTemplate.
	InstantiateEmptyItemTemplate	Popola l'oggetto Control specificato utilizzando i controlli figlio contenuti nel modello EmptyItemTemplate.
	InstantiateGroupSeparatorTemplate	Popola l'oggetto Control specificato utilizzando i controlli figlio contenuti nel modello GroupSeparatorTemplate.
	InstantiateGroupTemplate	Popola l'oggetto Control specificato utilizzando i controlli figlio contenuti nel modello GroupTemplate.
	InstantiateInsertItemTemplate	Popola l'oggetto Control specificato utilizzando i controlli figlio contenuti nel modello InsertItemTemplate.
	InstantiateItemSeparatorTemplate	Popola l'oggetto Control specificato utilizzando i controlli figlio contenuti nel modello ItemSeparatorTemplate.
	InstantiateItemTemplate	Popola l'oggetto Control specificato utilizzando i controlli figlio di uno dei modelli del controllo ListView.
	IsLiteralContent	Infrastruttura. Determina se il controllo server conserva solo il contenuto literal. (Ereditato da Control)
	LoadControlState	Carica lo stato delle proprietà del controllo ListView da mantenere, anche quando la proprietà EnableViewState è impostata su false. (Esegue l'override di Control.LoadControlState(Object)).
	LoadViewState	Carica lo stato di visualizzazione precedentemente salvato del controllo ListView. (Esegue l'override di WebControl.LoadViewState(Object)).
	MapPathSecure	Recupera il percorso fisico al quale è associato un percorso virtuale, assoluto o relativo. (Ereditato da Control)
	MarkAsDataBound	Imposta lo stato del controllo nello stato di visualizzazione come associato correttamente ai dati. (Ereditato da DataBoundControl)
	MemberwiseClone	Consente di creare una copia dei riferimenti dell'oggetto Object corrente. (Ereditato da Object)
	MergeStyle	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	Determina se è necessario gestire un evento per il controllo ListView. (Esegue l'override di Control.OnBubbleEvent(Object, EventArgs)).
	OnDataBinding	Genera l'evento DataBinding. (Ereditato da Control)
	OnDataBound	Genera l'evento DataBound. (Ereditato da BaseDataBoundControl)
	OnDataPropertyChanged	Riassocia il controllo con associazione a dati ai relativi dati dopo la modifica di una delle proprietà di identificazione dell'origine dati di base. (Ereditato da DataBoundControl)
	OnDataSourceViewChanged	Genera l'evento DataSourceViewChanged. (Ereditato da DataBoundControl)
	OnInit	Genera l'evento Init. (Esegue l'override di BaseDataBoundControl.OnInit(EventArgs)).
	OnItemCanceling	Genera l’evento ItemCanceling.
	OnItemCommand	Genera l'evento ItemCommand.
	OnItemCreated	Genera l'evento ItemCreated.
	OnItemDataBound	Genera l'evento ItemDataBound.
	OnItemDeleted	Genera l'evento ItemDeleted.
	OnItemDeleting	Genera l'evento ItemDeleting.
	OnItemEditing	Genera l’evento ItemEditing.
	OnItemInserted	Genera l'evento ItemInserted.
	OnItemInserting	Genera l'evento ItemInserting.
	OnItemUpdated	Genera l'evento ItemUpdated.
	OnItemUpdating	Genera l'evento ItemUpdating.
	OnLayoutCreated	Genera l'evento LayoutCreated.
	OnLoad	Consente di gestire l'evento Control.Load. (Ereditato da DataBoundControl)
	OnPagePreLoad	Imposta lo stato inizializzato del controllo con associazione a dati prima del caricamento del controllo. (Ereditato da DataBoundControl)
	OnPagePropertiesChanged	Genera l'evento PagePropertiesChanged.
	OnPagePropertiesChanging	Genera l'evento PagePropertiesChanging.
	OnPreRender	Gestisce l'evento PreRender. (Ereditato da BaseDataBoundControl)
	OnSelectedIndexChanged	Genera l'evento SelectedIndexChanged.
	OnSelectedIndexChanging	Genera l'evento SelectedIndexChanging.
	OnSorted	Genera l'evento Sorted.
	OnSorting	Genera l'evento Sorting.
	OnTotalRowCountAvailable	Genera l'evento IPageableItemContainer.TotalRowCountAvailable.
	OnUnload	Genera l'evento Unload. (Ereditato da Control)
	OpenFile	Ottiene un oggetto Stream utilizzato per leggere un file. (Ereditato da Control)
	PerformDataBinding	Associa il controllo ListView all'origine dati specificata. (Esegue l'override di DataBoundControl.PerformDataBinding(IEnumerable)).
	PerformSelect	Recupera i dati dall'origine dati associata. (Esegue l'override di DataBoundControl.PerformSelect()).
	RaiseBubbleEvent	Assegna eventuali origini dell'evento e relative informazioni al controllo padre. (Ereditato da Control)
	RemovedControl	Viene chiamato dopo la rimozione di un controllo figlio dall'insieme Controls dell'oggetto Control. (Ereditato da Control)
	RemoveItems	Elimina tutti i controlli figlio in un contenitore di elementi o gruppi del controllo ListView.
	Render	Esegue il rendering del contenuto del controllo server Web nel browser del client utilizzando l'oggetto HtmlTextWriter specificato. (Esegue l'override di WebControl.Render(HtmlTextWriter)).
	RenderBeginTag	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	Invia il contenuto di un controllo figlio del controllo server a un oggetto HtmlTextWriter fornito, che scrive il contenuto di cui verrà effettuato il rendering sul client. (Ereditato da Control)
	RenderContents	Esegue il rendering del contenuto del controllo nel writer specificato. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
	RenderControl(HtmlTextWriter)	Restituisce il contenuto del controllo server a un oggetto HtmlTextWriter fornito e memorizza le informazioni di tracciatura relative al controllo se questa funzionalità è attivata. (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	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	Ottiene un URL che può essere utilizzato dal browser. (Ereditato da Control)
	ResolveUrl	Converte un URL in un formato utilizzabile dal client richiedente. (Ereditato da Control)
	SaveControlState	Salva lo stato delle proprietà del controllo ListView da mantenere, anche quando la proprietà EnableViewState è impostata su false. (Esegue l'override di Control.SaveControlState()).
	SaveViewState	Salva lo stato di visualizzazione corrente del controllo ListView. (Esegue l'override di WebControl.SaveViewState()).
	SelectItem	Seleziona l'elemento in modalità di modifica in un controllo ListView.
	SetDesignModeState	Imposta i dati della fase di progettazione per un controllo. (Ereditato da Control)
	SetEditItem	Imposta l'elemento specificato in modalità di modifica in un controllo ListView.
	SetPageProperties	Imposta le proprietà di una pagina di dati nel controllo ListView.
	SetRenderMethodDelegate	Infrastruttura. Assegna un delegato del gestore eventi per eseguire il rendering del controllo server e del relativo contenuto nel controllo padre. (Ereditato da Control)
	Sort	Ordina il controllo ListView in base all'espressione e alla direzione di ordinamento specificate.
	ToString	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
	TrackViewState	Forza il controllo a tenere traccia dello modifiche apportate allo stato di visualizzazione in modo che vengano archiviate nella proprietà ViewState dell'oggetto. (Ereditato da WebControl)
	UpdateItem	Aggiorna nell'origine dati il record in corrispondenza dell'indice specificato.
	ValidateDataSource	Verifica la possibilità di utilizzare l'oggetto a cui è associato un controllo con associazione a dati. (Ereditato da DataBoundControl)

In alto

Eventi

	Nome	Descrizione
	DataBinding	Viene generato quando il controllo server viene associato a un'origine dati. (Ereditato da Control)
	DataBound	Viene dopo che un controllo server viene associato a un'origine dati. (Ereditato da BaseDataBoundControl)
	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)
	Init	Viene generato quando il controllo server viene inizializzato, ovvero nella prima fase della sua durata. (Ereditato da Control)
	ItemCanceling	Si verifica quando viene richiesta un'operazione di annullamento, ma prima che il controllo ListView annulli l'operazione di inserimento o modifica.
	ItemCommand	Si verifica quando viene fatto clic su un pulsante in un controllo ListView.
	ItemCreated	Viene generato quando viene creato un elemento all'interno di un controllo ListView.
	ItemDataBound	Si verifica quando un elemento dati viene associato ai dati in un controllo ListView.
	ItemDeleted	Si verifica quando viene richiesta un'operazione di eliminazione, dopo l'eliminazione dell'elemento da parte del controllo ListView.
	ItemDeleting	Si verifica quando viene richiesta un'operazione di eliminazione, ma prima dell'eliminazione dell'elemento da parte del controllo ListView.
	ItemEditing	Si verifica quando viene richiesta un'operazione di modifica, ma prima che l'elemento ListView venga impostato sulla modalità di modifica.
	ItemInserted	Si verifica quando è richiesta un'operazione di inserimento, dopo che il controllo ListView ha inserito l'elemento nell'origine dati.
	ItemInserting	Si verifica quando viene richiesta un'operazione di inserimento, ma prima che il controllo ListView esegua l'inserimento.
	ItemUpdated	Si verifica quando viene richiesta un'operazione di aggiornamento, dopo l'aggiornamento dell'elemento da parte del controllo ListView.
	ItemUpdating	Si verifica quando viene richiesta un'operazione di aggiornamento, ma prima dell'aggiornamento dell'elemento da parte del controllo ListView.
	LayoutCreated	Si verifica quando il modello LayoutTemplate viene creato in un controllo ListView.
	Load	Viene generato quando il controllo server è caricato nell'oggetto Page. (Ereditato da Control)
	PagePropertiesChanged	Si verifica quando le proprietà della pagina vengono modificate, dopo che il controllo ListView ha impostato i nuovi valori.
	PagePropertiesChanging	Si verifica quando le proprietà della pagina vengono modificate, ma prima che il controllo ListView imposti i nuovi valori.
	PreRender	Si verifica dopo il caricamento dell'oggetto Control ma prima del rendering. (Ereditato da Control)
	SelectedIndexChanged	Si verifica quando viene fatto clic sul pulsante Select di un elemento, ma dopo che il controllo ListView ha gestito l'operazione di selezione.
	SelectedIndexChanging	Si verifica quando viene fatto clic sul pulsante Select di un elemento, ma prima che il controllo ListView gestisca l'operazione di selezione.
	Sorted	Si verifica quando viene richiesta un'operazione di ordinamento, dopo che il controllo ListView ha gestito l'operazione di ordinamento.
	Sorting	Si verifica quando viene richiesta un'operazione di ordinamento, ma prima che il controllo ListView gestisca l'operazione di ordinamento.
	Unload	Viene generato quando il controllo server viene scaricato dalla memoria. (Ereditato da Control)

In alto

Metodi di estensione

	Nome	Descrizione
	EnableDynamicData(Type)	Sottoposto a overload. Abilita il comportamento dati dinamici per il controllo dei dati specificato. (Definito da DataControlExtensions).
	EnableDynamicData(Type, Object)	Sottoposto a overload. Abilita il comportamento dati dinamici per il controllo dei dati specificato. (Definito da DataControlExtensions).
	EnableDynamicData(Type, IDictionary<String, Object>)	Sottoposto a overload. Abilita il comportamento dati dinamici per il controllo dei dati specificato. (Definito da DataControlExtensions).
	EnablePersistedSelection	Consente alla selezione di essere persistente nei controlli dati che supportano la selezione e il paging. (Definito da DynamicDataExtensions).
	FindDataSourceControl	Restituisce l'origine dati associata al controllo dati per il controllo specificato. (Definito da DynamicDataExtensions).
	FindFieldTemplate	Restituisce il modello di campo per la colonna specificata nel contenitore di denominazione del controllo specificato. (Definito da DynamicDataExtensions).
	FindMetaTable	Restituisce l'oggetto metatabella per il controllo contenitore dei dati. (Definito da DynamicDataExtensions).
	GetDefaultValues	Ottiene l'insieme di valori predefiniti per il controllo dei dati specificato. (Definito da DynamicDataExtensions).
	GetMetaTable	Ottiene i metadati della tabella per il controllo dei dati specificato. (Definito da DynamicDataExtensions).
	SetMetaTable(MetaTable)	Sottoposto a overload. Imposta i metadati della tabella per il controllo dei dati specificato. (Definito da DynamicDataExtensions).
	SetMetaTable(MetaTable, IDictionary<String, Object>)	Sottoposto a overload. Imposta il mapping dei valori predefiniti e dei metadati della tabella per il controllo dei dati specificato. (Definito da DynamicDataExtensions).
	SetMetaTable(MetaTable, Object)	Sottoposto a overload. Imposta il mapping dei valori predefiniti e dei metadati della tabella per il controllo dei dati specificato. (Definito da DynamicDataExtensions).
	TryGetMetaTable	Determina se sono disponibili i metadati della tabella. (Definito da DynamicDataExtensions).

In alto

Implementazioni esplicite dell'interfaccia

	Nome	Descrizione
	IAttributeAccessor.GetAttribute	Infrastruttura. Ottiene un attributo del controllo Web con il nome specificato. (Ereditato da WebControl)
	IAttributeAccessor.SetAttribute	Imposta un attributo del controllo Web sul nome e il valore specificati. (Ereditato da WebControl)
	IControlBuilderAccessor.ControlBuilder	Per una descrizione di questo membro, vedere IControlBuilderAccessor.ControlBuilder. (Ereditato da Control)
	IControlDesignerAccessor.GetDesignModeState	Per una descrizione di questo membro, vedere IControlDesignerAccessor.GetDesignModeState. (Ereditato da Control)
	IControlDesignerAccessor.SetDesignModeState	Per una descrizione di questo membro, vedere IControlDesignerAccessor.SetDesignModeState. (Ereditato da Control)
	IControlDesignerAccessor.SetOwnerControl	Infrastruttura. Per una descrizione di questo membro, vedere IControlDesignerAccessor.SetOwnerControl. (Ereditato da Control)
	IControlDesignerAccessor.UserData	Per una descrizione di questo membro, vedere IControlDesignerAccessor.UserData. (Ereditato da Control)
	IDataBindingsAccessor.DataBindings	Per una descrizione di questo membro, vedere IDataBindingsAccessor.DataBindings. (Ereditato da Control)
	IDataBindingsAccessor.HasDataBindings	Per una descrizione di questo membro, vedere IDataBindingsAccessor.HasDataBindings. (Ereditato da Control)
	IDataBoundControl.DataKeyNames	Ottiene o imposta una matrice contenente i nomi dei campi di chiave primaria degli elementi visualizzati in un controllo associato a dati.
	IDataBoundControl.DataMember	Ottiene o imposta il nome dell'elenco di dati a cui viene associato il controllo associato a dati quando l'origine dati contiene più elenchi distinti di elementi di dati.
	IDataBoundControl.DataSource	Ottiene o imposta l'oggetto da cui un controllo associato a dati recupera il relativo elenco di elementi di dati.
	IDataBoundControl.DataSourceID	Ottiene o imposta l'ID del controllo origine dati da cui un controllo associato a dati recupera il relativo elenco di elementi di dati.
	IDataBoundControl.DataSourceObject	Ottiene un oggetto che implementa l'interfaccia IDataSource che fornisce l'accesso al contenuto dati dell'oggetto.
	IDataBoundListControl.ClientIDRowSuffix	Ottiene il nome del campo dati il cui valore viene utilizzato per identificare in modo univoco ogni riga di dati di un controllo ListView quando la proprietà ClientIDMode è impostata su Predictable.
	IDataBoundListControl.DataKeys	Ottiene un insieme di valori della chiave di dati che rappresentano ogni riga di un controllo associato a dati.
	IDataBoundListControl.EnablePersistedSelection	Ottiene o imposta il valore che specifica se una riga selezionata resta memorizzata quando un utente si sposta tra i dati in un controllo associato a dati.
	IDataBoundListControl.SelectedDataKey	Ottiene l'oggetto chiave di dati contenente il valore della chiave di dati per la riga selezionata in un controllo associato a dati.
	IDataBoundListControl.SelectedIndex	Ottiene o imposta l'indice della riga selezionata in un controllo associato a dati.
	IDataKeysControl.ClientIDRowSuffixDataKeys	Infrastruttura. Ottiene un insieme di valori dei dati utilizzati per identificare in modo univoco ogni istanza di un controllo associato a dati quando ASP.NET genera il valore ClientID.
	IExpressionsAccessor.Expressions	Per una descrizione di questo membro, vedere IExpressionsAccessor.Expressions. (Ereditato da Control)
	IExpressionsAccessor.HasExpressions	Per una descrizione di questo membro, vedere IExpressionsAccessor.HasExpressions. (Ereditato da Control)
	IPageableItemContainer.MaximumRows	Infrastruttura. Per una descrizione di questo membro, vedere il metodo IPageableItemContainer.MaximumRows.
	IPageableItemContainer.SetPageProperties	Infrastruttura. Per una descrizione di questo membro, vedere il metodo IPageableItemContainer.SetPageProperties.
	IPageableItemContainer.StartRowIndex	Infrastruttura. Per una descrizione di questo membro, vedere il metodo IPageableItemContainer.StartRowIndex.
	IPageableItemContainer.TotalRowCountAvailable	Infrastruttura. Per una descrizione di questo membro, vedere il metodo IPageableItemContainer.TotalRowCountAvailable.
	IParserAccessor.AddParsedSubObject	Per una descrizione di questo membro, vedere IParserAccessor.AddParsedSubObject. (Ereditato da Control)
	IPersistedSelector.DataKey	Ottiene o imposta il valore della chiave di dati per il record selezionato in un controllo con associazione a dati.

In alto

Note

In questo argomento:

Introduzione
Modelli
Associazione a un'origine dati
Operazioni sui dati
Eventi
Sintassi dichiarativa

Introduzione

Il controllo ListView viene utilizzato per visualizzare i valori provenienti da un'origine dati. È simile al controllo GridView, ma visualizza i dati utilizzando modelli definiti dall'utente anziché campi riga. La creazione di modelli personalizzati consente di definire con maggiore flessibilità la modalità di visualizzazione dei dati.

Come complemento a questo argomento è disponibile un progetto di Visual Studio con codice sorgente: Download.

Nel controllo ListView sono supportate le seguenti funzionalità:

Supporto dell'associazione a controlli origine dati come SqlDataSource, LinqDataSource e ObjectDataSource.
Possibilità di personalizzare l'aspetto tramite stili e modelli definiti dall'utente.
Funzionalità di ordinamento incorporate.
Funzionalità di aggiornamento ed eliminazione incorporate.
Funzionalità di inserimento incorporate.
Supporto delle funzionalità di paging utilizzando un controllo DataPager.
Funzionalità di selezione di elementi incorporate.
Accesso a livello di codice al modello a oggetti ListView per impostare dinamicamente le proprietà, gestire gli eventi e così via.
Supporto di più campi chiave.

Per informazioni su altri controlli con associazione a dati disponibili in ASP.NET, vedere Cenni preliminari sui controlli server Web ASP.NET con associazione a dati.

Modelli

Per consentire al controllo ListView di visualizzare contenuto, è necessario creare modelli per le diverse parti del controllo. Il ItemTemplate è obbligatorio. Tutti gli altri modelli sono facoltativi. La proprietà LayoutTemplate non è richiesta.

È tuttavia necessario creare un modello per la modalità in cui è configurato il controllo. Per un controllo ListView che supporta l'inserimento di record, ad esempio, è necessario definire un modello InsertItemTemplate. Nella tabella riportata di seguito sono elencati i diversi modelli che è possibile creare per il controllo ListView.

Tipo di modello	Oggetto di descrizione
LayoutTemplate	Modello radice che definisce un oggetto contenitore, ad esempio un elemento table, div o span che includerà il contenuto definito nel modello ItemTemplate o GroupTemplate. Può inoltre contenere un oggetto DataPager.
ItemTemplate	Definisce il contenuto con associazione a dati da visualizzare per singoli elementi.
ItemSeparatorTemplate	Definisce il contenuto di cui eseguire il rendering tra singoli elementi.
GroupTemplate	Definisce un oggetto contenitore, ad esempio un elemento riga di una tabella (tr), div o span che includerà il contenuto definito nei modelli ItemTemplate e EmptyItemTemplate. Il numero di elementi visualizzati in un gruppo viene specificato dalla proprietà GroupItemCount.
GroupSeparatorTemplate	Definisce il contenuto di cui eseguire il rendering tra gruppi di elementi.
EmptyItemTemplate	Definisce il contenuto di cui eseguire il rendering per un elemento vuoto quando viene utilizzato un modello GroupTemplate. Se ad esempio la proprietà GroupItemCount è impostata su 5 e il numero totale di elementi restituiti dall'origine dati è 8, l'ultimo gruppo di dati visualizzato dal controllo ListView conterrà tre elementi, in base a quanto specificato dal modello ItemTemplate e due elementi in base a quanto specificato dal modello EmptyItemTemplate.
EmptyDataTemplate	Definisce il contenuto di cui eseguire il rendering se l'origine dati non restituisce dati.
SelectedItemTemplate	Definisce il contenuto di cui eseguire il rendering per l'elemento dati selezionato per differenziarlo da altri elementi.
AlternatingItemTemplate	Definisce il contenuto di cui eseguire il rendering per gli elementi alternati per semplificare la distinzione tra elementi consecutivi.
EditItemTemplate	Definisce il contenuto di cui eseguire il rendering quando un elemento viene modificato. Viene eseguito il rendering del modello EditItemTemplate anziché del modello ItemTemplate per l'elemento dati in corso di modifica.
InsertItemTemplate	Definisce il contenuto di cui eseguire il rendering per inserire un elemento. Viene eseguito il rendering del modello InsertItemTemplate anziché di un modello ItemTemplate all'inizio o alla fine degli elementi visualizzati dal controllo ListView. È possibile specificare dove eseguire il rendering del modello InsertItemTemplate utilizzando la proprietà InsertItemPosition del controllo ListView.

Per visualizzare il valore di un campo in un modello come ItemTemplate, viene utilizzata un'espressione di associazione dati. Per ulteriori informazioni sulle espressioni di associazione dati, vedere Cenni preliminari sulle espressioni di associazione dati.

Per associare i controlli di input nei modelli EditItemTemplate e InsertItemTemplate ai campi di un'origine dati, è possibile utilizzare espressioni di associazione bidirezionali. In questo modo il controllo ListView può estrarre automaticamente i valori del controllo di input di un'operazione di aggiornamento o inserimento. Le espressioni di associazione bidirezionale consentono inoltre ai controlli di input presenti in un oggetto EditItemTemplate di visualizzare automaticamente i valori dei campi originali. Per ulteriori informazioni sulle espressioni di associazione bidirezionale, vedere Associazione a database.

Associazione a un'origine dati

È possibile associare il controllo ListView a un controllo origine dati, ad esempio SqlDataSource o ObjectDataSource, o a qualsiasi insieme dell'origine dati che implementi l'interfaccia System.Collections.IEnumerable, ad esempio System.Data.DataView, System.Collections.ArrayList, System.Collections.Generic.List<T> o altri tipi di insiemi. Per associare il controllo ListView al tipo di origine dati appropriato, procedere in uno dei seguenti modi:

Per effettuare l'associazione a un controllo origine dati, impostare la proprietà DataSourceID del controllo ListView sul valore ID del controllo origine dati. Il controllo ListView verrà associato automaticamente al controllo origine dati specificato e potrà sfruttare le funzionalità di quest'ultimo per eseguire operazioni di ordinamento, inserimento, aggiornamento, eliminazione e paging. Si tratta del metodo di associazione a dati maggiormente utilizzato.
Per effettuare l'associazione a un'origine dati che implementa l'interfaccia System.Collections.IEnumerable, impostare a livello di codice la proprietà DataSource del controllo ListView sull'origine dati, quindi chiamare il metodo DataBind. Quando si utilizza questa tecnica, il controllo ListView non include funzionalità incorporate di ordinamento, aggiornamento, eliminazione e paging. Per renderle disponibili, è pertanto necessario utilizzare l'evento appropriato.

Per ulteriori informazioni sull'associazione dati, vedere Accesso ai dati tramite ASP.NET.

Nota
Il controllo ListView può essere utilizzato per visualizzare l'input dell'utente, che potrebbe includere uno script client non autorizzato. Controllare tutte le informazioni inviate da un client relative a script eseguibile, istruzioni SQL o altro codice prima di visualizzarle nell'applicazione. Quando è possibile, è consigliabile codificare i valori in formato HTML prima che vengano visualizzati nel controllo. ASP.NET dispone di una funzione di convalida della richiesta di input che consente di bloccare script e codice HTML nell'input dell'utente. È inoltre possibile utilizzare i controlli server di convalida per controllare l'input dell'utente. Per ulteriori informazioni, vedere Introduction to the Validation Controls.

Nota

Il controllo ListView può essere utilizzato per visualizzare l'input dell'utente, che potrebbe includere uno script client non autorizzato. Controllare tutte le informazioni inviate da un client relative a script eseguibile, istruzioni SQL o altro codice prima di visualizzarle nell'applicazione. Quando è possibile, è consigliabile codificare i valori in formato HTML prima che vengano visualizzati nel controllo. ASP.NET dispone di una funzione di convalida della richiesta di input che consente di bloccare script e codice HTML nell'input dell'utente. È inoltre possibile utilizzare i controlli server di convalida per controllare l'input dell'utente. Per ulteriori informazioni, vedere Introduction to the Validation Controls.

Operazioni sui dati

Quando il controllo ListView è associato a un controllo origine dati, può sfruttare le funzionalità di quest'ultimo e consente di eseguire operazioni automatiche di ordinamento, inserimento, aggiornamento ed eliminazione.

Nota
Il controllo ListView può fornire il supporto per operazioni di ordinamento, inserimento, aggiornamento ed eliminazione con altri tipi di origini dati. Tuttavia, per implementare queste operazioni, è necessario creare codice in un gestore eventi appropriato.

Poiché il controllo ListView utilizza i modelli, non consente di generare automaticamente i pulsanti per l'esecuzione di operazioni di aggiornamento, eliminazione, inserimento, ordinamento o selezione. Sarà pertanto necessario includere manualmente tali pulsanti nel modello appropriato. Il controllo ListView riconosce alcuni pulsanti la cui proprietà CommandName sia impostata su un valore specifico. Nella tabella riportata di seguito sono elencati i pulsanti riconosciuti dal controllo ListView e le relative funzioni.

Button	Valore CommandName	Oggetto di descrizione
Cancel	"Cancel"	Annulla un'operazione di modifica o di inserimento. Genera l’evento ItemCanceling.
Delete	"Delete"	Elimina il record corrente dall'origine dati. Genera gli eventi ItemDeleted e ItemDeleting.
Seleziona	"Select"	Imposta la proprietà SelectedIndex sul valore della proprietà DisplayIndex per l'elemento. Esegue il rendering del modello SelectedItemTemplate per l'elemento. Genera gli eventi SelectedIndexChanging e SelectedIndexChanged.
Edit	"Edit"	Imposta l'elemento sulla modalità di modifica. Esegue il rendering del modello EditItemTemplate per l'elemento. Genera l’evento ItemEditing.
Insert	"Insert"	Inserisce i valori associati dal modello InsertItemTemplate nell'origine dati. Genera gli eventi ItemInserting e ItemInserted.
Aggiorna	"Update"	Aggiorna il record corrente nell'origine dati con i valori associati dal modello EditItemTemplate. Genera gli eventi ItemUpdating e ItemUpdated.
Sort	"Sort"	Ordina le colonne elencate nella proprietà CommandArgument del pulsante. Genera gli eventi Sorting e Sorted.

Contrariamente a quanto avviene con il pulsante Delete, che elimina immediatamente l'elemento dati corrente, quando viene fatto clic sul pulsante Edit, il controllo ListView visualizza l'elemento corrente in modalità di modifica. Quando è attivata la modalità di modifica, per l'elemento di dati corrente viene visualizzato il contenuto della proprietà EditItemTemplate. Nel modello per la modifica di elementi in genere il pulsante Edit viene sostituito da un pulsante Update e Cancel. I controlli di input appropriati per il tipo di dati del campo, ad esempio un controllo TextBox o CheckBox in genere visualizzano un valore del campo modificabile dall'utente. Se viene fatto clic sul pulsante Update, il record viene aggiornato nell'origine dati e se viene fatto clic sul pulsante Cancel l'operazione di modifica viene annullata.

La funzionalità di inserimento viene abilitata quando la proprietà InsertItemPosition è impostata su FirstItem o LastItem. Questa proprietà definisce la posizione in cui viene eseguito il rendering del modello InsertItemTemplate per l'elemento di inserimento. Tale modello in genere include un pulsante Insert e un pulsante Cancel e controlli di input vuoti che vengano visualizzati per consentire all'utente di immettere i valori per il nuovo record. Quando viene fatto clic sul pulsante Insert, il record viene inserito nell'origine dati, mentre quando viene fatto clic sul pulsante Cancel viene cancellato il contenuto di tutti i campi.

Ordinamento

Il controllo ListView consente agli utenti di ordinare gli elementi facendo clic sul pulsante Sort. La funzionalità di ordinamento viene definita nella proprietà CommandArgument del pulsante contenente le colonne da ordinare.

Paging

Anziché visualizzare contemporaneamente tutti i record dell'origine dati, il controllo ListView può suddividere i record in pagine. Per abilitare il paging, associare un controllo DataPager al controllo ListView. Inserire quindi un controllo DataPager nel modello LayoutTemplate. In alternativa, se il controllo DataPager si trova al di fuori del controllo ListView, impostare la proprietà PagedControlID sulla proprietà ID del controllo ListView.

Eventi

Nella tabella riportata di seguito sono elencati gli eventi supportati dal controllo ListView.

Evento	Oggetto di descrizione
ItemCanceling	Si verifica quando viene fatto clic sul pulsante Cancel, ovvero un pulsante con la proprietà CommandName impostata su "Cancel", ma prima che il controllo ListView annulli l'operazione di inserimento o modifica. Questo evento viene spesso utilizzato per interrompere l'operazione di annullamento.
ItemCommand	Si verifica quando viene fatto clic su un pulsante nel controllo ListView. Questo evento viene spesso utilizzato per eseguire un'operazione personalizzata quando viene fatto clic su un pulsante nel controllo.
ItemCreated	Si verifica quando viene creato un nuovo elemento nel controllo ListView. Questo evento viene spesso utilizzato per modificare il contenuto di un elemento quando quest'ultimo viene creato.
ItemDataBound	Si verifica quando un elemento di dati viene associato a dati nel controllo ListView. Questo evento viene spesso utilizzato per modificare il contenuto di un elemento quando quest'ultimo viene associato a dati.
ItemDeleted	Si verifica quando viene fatto clic su un pulsante Delete, ovvero un pulsante la cui proprietà CommandName è impostata su "Delete", oppure quando viene chiamato il metodo DeleteItem, dopo l'eliminazione del record da parte del controllo ListView dall'origine dati. Questo evento viene spesso utilizzato per verificare i risultati dell'operazione di eliminazione.
ItemDeleting	Si verifica quando viene fatto clic su un pulsante Delete, ovvero un pulsante la cui proprietà CommandName è impostata su "Delete", oppure quando viene chiamato il metodo DeleteItem, ma prima dell'eliminazione del record da parte del controllo ListView dall'origine dati. Questo evento viene spesso utilizzato per confermare o annullare l'operazione di eliminazione.
ItemEditing	Si verifica quando viene fatto clic su un pulsante Edit, ovvero un pulsante la cui proprietà CommandName è impostata su "Edit", ma prima che il controllo ListView venga impostato sulla modalità di modifica. Questo evento viene spesso utilizzato per annullare l'operazione di modifica.
ItemInserted	Si verifica quando viene fatto clic su un pulsante Insert, ovvero un pulsante la cui proprietà CommandName è impostata su "Insert", oppure quando viene chiamato il metodo InsertNewItem, dopo l'inserimento di un nuovo record da parte del controllo ListView dall'origine dati. Questo evento viene spesso utilizzato per verificare i risultati dell'operazione di inserimento.
ItemInserting	Si verifica quando viene fatto clic su un pulsante Insert, ovvero un pulsante la cui proprietà CommandName è impostata su "Insert", oppure quando viene chiamato il metodo InsertNewItem, ma prima dell'inserimento del record da parte del controllo ListView. Questo evento viene spesso utilizzato per annullare l'operazione di inserimento o per modificare o convalidare i valori del nuovo elemento.
ItemUpdated	Si verifica quando viene fatto clic sul pulsante Update, ovvero un pulsante la cui proprietà CommandName è impostata su "Update", oppure quando viene chiamato il metodo UpdateItem, dopo l'aggiornamento del record da parte del controllo ListView. Questo evento viene spesso utilizzato per verificare i risultati dell'operazione di aggiornamento.
ItemUpdating	Si verifica quando viene fatto clic sul pulsante Update, ovvero un pulsante la cui proprietà CommandName è impostata su "Update", oppure quando viene chiamato il metodo UpdateItem, ma prima dell'aggiornamento del record da parte del controllo ListView. Questo evento viene spesso utilizzato per annullare l'operazione di aggiornamento o per modificare o convalidare i valori dell'elemento modificato.
LayoutCreated	Si verifica quando il modello LayoutTemplate viene creato in un controllo ListView. Questo evento viene spesso utilizzato per eseguire un'operazione dopo aver creato il modello.
PagePropertiesChanged	Si verifica quando le proprietà della pagina vengono modificate, dopo che il controllo ListView ha impostato i nuovi valori.
PagePropertiesChanging	Si verifica quando le proprietà della pagina di dati vengono modificate, ma prima che il controllo ListView imposti i nuovi valori.
SelectedIndexChanged	Si verifica quando viene fatto clic su un pulsante Select, ovvero un pulsante la cui proprietà CommandName è impostata su "Select", dopo che il controllo ListView ha gestito l'operazione di selezione. Questo evento viene spesso utilizzato per eseguire un'operazione personalizzata dopo che è stato selezionato un elemento nel controllo.
SelectedIndexChanging	Si verifica quando viene fatto clic su un pulsante Select, ovvero un pulsante la cui proprietà CommandName è impostata su "Select", ma prima che il controllo ListView gestisca l'operazione di selezione. Questo evento viene spesso utilizzato per annullare l'operazione di selezione.
Sorted	Si verifica quando viene fatto clic sul pulsante Sort, ovvero un pulsante la cui proprietà CommandName è impostata su "Sort" oppure quando viene chiamato il metodo Sort, dopo che il controllo ListView ha gestito l'operazione di ordinamento. Questo evento in genere viene utilizzato per eseguire un'operazione personalizzata dopo che un utente ha fatto clic su un pulsante Sort e dopo l'ordinamento dei dati.
Sorting	Si verifica quando viene fatto clic sul pulsante Sort, ovvero un pulsante la cui proprietà CommandName è impostata su "Sort", oppure quando viene chiamato il metodo Sort, ma prima che il controllo ListView gestisca l'operazione di ordinamento. Questo evento viene spesso utilizzato per annullare l'operazione di ordinamento o per eseguire una routine di ordinamento personalizzata.

Sintassi dichiarativa

<asp:ListView
    ConvertEmptyStringToNull="True|False"
    DataKeyNames="string"
    DataMember="string"
    DataSource="string"
    DataSourceID="string"
    EditIndex="integer"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    GroupPlaceholderID="string"
    GroupItemCount="integer"
    ID="string"
    InsertItemPosition="None|FirstItem|LastItem"
    ItemPlaceholderID="string"
    OnDataBinding="DataBinding event handler"
    OnDataBound="DataBound event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnItemCanceling="ItemCanceling event handler"
    OnItemCommand="ItemCommand event handler"
    OnItemCreated="ItemCreated event handler"
    OnItemDataBound="ItemDataBound event handler"
    OnItemDeleted="ItemDeleted event handler"
    OnItemDeleting="ItemDeleting event handler"
    OnItemEditing="ItemEditing event handler"
    OnItemInserted="ItemInserted event handler"
    OnItemInserting="ItemInserting event handler"
    OnItemUpdated="ItemUpdated event handler"
    OnItemUpdating="ItemUpdating event handler"
    OnLayoutCreated="LayoutCreated event handler"
    OnLoad="Load event handler"
    OnPagePropertiesChanged="PagePropertiesChanged event handler"
    OnPagePropertiesChanging="PagePropertiesChanging event handler"
    OnPreRender="PreRender event handler"
    OnSelectedIndexChanged="SelectedIndexChanged event handler"
    OnSelectedIndexChanging="SelectedIndexChanging event handler"
    OnSorted="Sorted event handler"
    OnSorting="Sorting event handler"
    OnUnload="Unload event handler"
    runat="server"
    SelectedIndex="integer"
    SkinID="string"
    Style="string"
    Visible="True|False"
>
        <AlternatingItemTemplate>
            <!-- child controls -->
        </AlternatingItemTemplate>
        <EditItemTemplate>
            <!-- child controls -->
        </EditItemTemplate>
        <EmptyDataTemplate>
            <!-- child controls -->
        </EmptyDataTemplate>
        <EmptyItemTemplate>
            <!-- child controls -->
        </EmptyItemTemplate>
        <GroupSeparatorTemplate>
            <!-- child controls -->
        </GroupSeparatorTemplate>
        <GroupTemplate>
            <!-- child controls -->
        </GroupTemplate>
        <InsertItemTemplate>
            <!-- child controls -->
        </InsertItemTemplate>
        <ItemSeparatorTemplate>
            <!-- child controls -->
        </ItemSeparatorTemplate>
        <ItemTemplate>
            <!-- child controls -->
        </ItemTemplate>
        <LayoutTemplate>
                <!-- child controls -->
        </LayoutTemplate>
        <SelectedItemTemplate>
            <!-- child controls -->
        </SelectedItemTemplate>
</asp:ListView>

Esempi

Nell'esempio riportato di seguito viene illustrato come utilizzare il controllo ListView per visualizzare record da un database utilizzando una tabella HTML. I valori vengono recuperati tramite un controllo LinqDataSource.

Visual Basic


<%@ Page language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head id="Head1" runat="server">
    <title>ListView Example</title>
  </head>
  <body>
    <form id="form1" runat="server">

      <h3>ListView Example</h3>

      <asp:ListView ID="VendorsListView"
        DataSourceID="VendorsDataSource"
        DataKeyNames="VendorID"
        runat="server">
        <LayoutTemplate>
          <table cellpadding="2" width="640px" border="1" ID="tbl1" runat="server">
            <tr runat="server" style="background-color: #98FB98">
              <th runat="server">ID</th>
              <th runat="server">Account Number</th>
              <th runat="server">Name</th>
              <th runat="server">Preferred Vendor</th>
            </tr>
            <tr runat="server" id="itemPlaceholder" />
          </table>
          <asp:DataPager ID="DataPager1" runat="server">
            <Fields>
              <asp:NumericPagerField />
            </Fields>
          </asp:DataPager>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:Label ID="VendorIDLabel" runat="server" Text='<%# Eval("VendorID") %>' />
            </td>
            <td>
              <asp:Label ID="AccountNumberLabel" runat="server" Text='<%# Eval("AccountNumber") %>' />
            </td>
            <td>
              <asp:Label ID="NameLabel" runat="server" Text='<%# Eval("Name") %>' /></td>
            <td>
              <asp:CheckBox ID="PreferredCheckBox" runat="server" 
                Checked='<%# Eval("PreferredVendorStatus") %>' Enabled="False" />
            </td>
          </tr>
        </ItemTemplate>
      </asp:ListView>

      <!-- This example uses Microsoft SQL Server and connects   -->
      <!-- to the AdventureWorks sample database. Add a LINQ     -->
      <!-- to SQL class to the project to map to a table in      -->
      <!-- the database.                                         -->
      <asp:LinqDataSource ID="VendorsDataSource" runat="server" 
        ContextTypeName="AdventureWorksClassesDataContext" 
        Select="new (VendorID, AccountNumber, Name, PreferredVendorStatus)" 
        TableName="Vendors" Where="ActiveFlag == @ActiveFlag">
        <WhereParameters>
          <asp:Parameter DefaultValue="true" Name="ActiveFlag" Type="Boolean" />
        </WhereParameters>
      </asp:LinqDataSource>

    </form>
  </body>
</html>


<%@ Page language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head id="Head1" runat="server">
    <title>ListView Example</title>
  </head>
  <body>
    <form id="form1" runat="server">

      <h3>ListView Example</h3>

      <asp:ListView ID="VendorsListView"
        DataSourceID="VendorsDataSource"
        DataKeyNames="VendorID"
        runat="server">
        <LayoutTemplate>
          <table cellpadding="2" width="640px" border="1" ID="tbl1" runat="server">
            <tr runat="server" style="background-color: #98FB98">
              <th runat="server">ID</th>
              <th runat="server">Account Number</th>
              <th runat="server">Name</th>
              <th runat="server">Preferred Vendor</th>
            </tr>
            <tr runat="server" id="itemPlaceholder" />
          </table>
          <asp:DataPager ID="DataPager1" runat="server">
            <Fields>
              <asp:NumericPagerField />
            </Fields>
          </asp:DataPager>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:Label ID="VendorIDLabel" runat="server" Text='<%# Eval("VendorID") %>' />
            </td>
            <td>
              <asp:Label ID="AccountNumberLabel" runat="server" Text='<%# Eval("AccountNumber") %>' />
            </td>
            <td>
              <asp:Label ID="NameLabel" runat="server" Text='<%# Eval("Name") %>' /></td>
            <td>
              <asp:CheckBox ID="PreferredCheckBox" runat="server" 
                Checked='<%# Eval("PreferredVendorStatus") %>' Enabled="False" />
            </td>
          </tr>
        </ItemTemplate>
      </asp:ListView>

      <!-- This example uses Microsoft SQL Server and connects   -->
      <!-- to the AdventureWorks sample database. Add a LINQ     -->
      <!-- to SQL class to the project to map to a table in      -->
      <!-- the database.                                         -->
      <asp:LinqDataSource ID="VendorsDataSource" runat="server" 
        ContextTypeName="AdventureWorksClassesDataContext" 
        Select="new (VendorID, AccountNumber, Name, PreferredVendorStatus)" 
        TableName="Vendors" Where="ActiveFlag == @ActiveFlag">
        <WhereParameters>
          <asp:Parameter DefaultValue="true" Name="ActiveFlag" Type="Boolean" />
        </WhereParameters>
      </asp:LinqDataSource>

    </form>
  </body>
</html>

Nell'esempio riportato di seguito viene illustrato come utilizzare il controllo ListView per visualizzare valori in un layout di flusso utilizzando l'elemento div. I valori vengono recuperati tramite un controllo SqlDataSource.

Visual Basic


<%@ Page language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head id="Head1" runat="server">
    <title>ListView Flow Layout Example</title>
    <style type="text/css">
      .plainBox {
          font-family: Verdana, Arial, sans-serif;
          font-size: 11px;
          background: #ffffff;
          border:1px solid #336666;
          }
    </style>
  </head>
  <body>
    <form id="form1" runat="server">

      <h3>ListView Flow Layout Example</h3>

      Select the color:
      <asp:DropDownList ID="ColorList" runat="server" 
        AutoPostBack="True" 
        DataSourceID="ColorDataSource" 
        DataTextField="Color" 
        DataValueField="Color">
      </asp:DropDownList><br /><br />

      <asp:ListView runat="server" ID="ProductListView"
        DataSourceID="ProductsDataSource"
        DataKeyNames="ProductID">
        <LayoutTemplate>
          <div runat="server" id="lstProducts">
            <div runat="server" id="itemPlaceholder" />
          </div>
          <asp:DataPager ID="DataPager1" runat="server" PageSize="5" >
            <Fields>
              <asp:NextPreviousPagerField 
                ButtonType="Button"
                ShowFirstPageButton="True" 
                ShowLastPageButton="True" />
            </Fields>
          </asp:DataPager>
        </LayoutTemplate>
        <ItemTemplate>
          <asp:Image ID="ProductImage" runat="server"
            ImageUrl='<%# "~/images/thumbnails/" & Eval("ThumbnailPhotoFileName") %>' />	        
          <div class="plainBox" runat="server">
            <asp:HyperLink ID="ProductLink" runat="server" Text='<%# Eval("Name") %>' 
              NavigateUrl='<%# "ProductDetails.aspx?productID=" & Eval("ProductID") %>' />
            <br /><br />
            <b>Price:</b> 
            <asp:Label ID="PriceLabel" runat="server" Text='<%# Eval("ListPrice", "{0:c}")%>' /> <br />
          </div>
          <br />
        </ItemTemplate>
      </asp:ListView>

      <!-- This example uses Microsoft SQL Server and connects      -->
      <!-- to the AdventureWorks sample database. Use an ASP.NET    -->
      <!-- expression to retrieve the connection string value       -->
      <!-- from the Web.config file.                                -->
      <asp:SqlDataSource ID="ProductsDataSource" runat="server" 
        ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"            	        
        SelectCommand="SELECT P.ProductID, P.Name, P.Color, P.ListPrice, 
          PF.ThumbnailPhotoFileName, P.Size
          FROM Production.Product AS P 
          INNER JOIN Production.ProductProductPhoto AS PPF ON P.ProductID = PPF.ProductID 
          INNER JOIN Production.ProductPhoto AS PF ON PPF.ProductPhotoID = PF.ProductPhotoID
          WHERE P.Color = @Color" >
        <SelectParameters>
          <asp:ControlParameter ControlID="ColorList" Name="Color" 
            PropertyName="SelectedValue" />
        </SelectParameters>
      </asp:SqlDataSource>

      <asp:SqlDataSource ID="ColorDataSource" runat="server" 
        ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>" 
        SelectCommand="SELECT DISTINCT Color FROM Production.Product">
      </asp:SqlDataSource>

    </form>
  </body>
</html>


<%@ Page language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head id="Head1" runat="server">
    <title>ListView Flow Layout Example</title>
    <style type="text/css">
      .plainBox {
          font-family: Verdana, Arial, sans-serif;
          font-size: 11px;
          background: #ffffff;
          border:1px solid #336666;
          }
    </style>
  </head>
  <body>
    <form id="form1" runat="server">

      <h3>ListView Flow Layout Example</h3>

      Select the color:
      <asp:DropDownList ID="ColorList" runat="server" 
        AutoPostBack="True" 
        DataSourceID="ColorDataSource" 
        DataTextField="Color" 
        DataValueField="Color">
      </asp:DropDownList><br /><br />

      <asp:ListView runat="server" ID="ProductListView"
        DataSourceID="ProductsDataSource"
        DataKeyNames="ProductID">
        <LayoutTemplate>
          <div runat="server" id="lstProducts">
            <div runat="server" id="itemPlaceholder" />
          </div>
          <asp:DataPager runat="server" PageSize="5" >
            <Fields>
              <asp:NextPreviousPagerField 
                ButtonType="Button"
                ShowFirstPageButton="True" 
                ShowLastPageButton="True" />
            </Fields>
          </asp:DataPager>
        </LayoutTemplate>
        <ItemTemplate>
          <asp:Image ID="ProductImage" runat="server"
            ImageUrl='<%# "~/images/thumbnails/" + Eval("ThumbnailPhotoFileName") %>' />	        
          <div class="plainBox" runat="server">
            <asp:HyperLink ID="ProductLink" runat="server" Text='<%# Eval("Name") %>' 
              NavigateUrl='<%# "ProductDetails.aspx?productID=" + Eval("ProductID") %>' />
            <br /><br />
            <b>Price:</b> 
            <asp:Label ID="PriceLabel" runat="server" Text='<%# Eval("ListPrice", "{0:c}")%>' /> <br />
          </div>
          <br />
        </ItemTemplate>
      </asp:ListView>

      <!-- This example uses Microsoft SQL Server and connects      -->
      <!-- to the AdventureWorks sample database. Use an ASP.NET    -->
      <!-- expression to retrieve the connection string value       -->
      <!-- from the Web.config file.                                -->
      <asp:SqlDataSource ID="ProductsDataSource" runat="server" 
        ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"            	        
        SelectCommand="SELECT P.ProductID, P.Name, P.Color, P.ListPrice, 
          PF.ThumbnailPhotoFileName, P.Size
          FROM Production.Product AS P 
          INNER JOIN Production.ProductProductPhoto AS PPF ON P.ProductID = PPF.ProductID 
          INNER JOIN Production.ProductPhoto AS PF ON PPF.ProductPhotoID = PF.ProductPhotoID
          WHERE P.Color = @Color" >
        <SelectParameters>
          <asp:ControlParameter ControlID="ColorList" Name="Color" 
            PropertyName="SelectedValue" />
        </SelectParameters>
      </asp:SqlDataSource>

      <asp:SqlDataSource ID="ColorDataSource" runat="server" 
        ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>" 
        SelectCommand="SELECT DISTINCT Color FROM Production.Product">
      </asp:SqlDataSource>

    </form>
  </body>
</html>

Nell'esempio riportato di seguito viene illustrato come utilizzare il controllo ListView per inserire, eliminare e aggiornare record.

Nota sulla sicurezza
L'esempio include una casella di testo che accetta l'input dell'utente e rappresenta quindi una potenziale minaccia alla sicurezza. Per impostazione predefinita, le pagine Web ASP.NET convalidano l'input utente in modo che non includa script o elementi HTML. Per ulteriori informazioni, vedere Cenni preliminari sugli attacchi tramite script.

Visual Basic


<%@ Page language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head id="Head1" runat="server">
    <title>ListView Example</title>
    <style type="text/css">
        .EditItem { background-color:#8FBC8F;}
        .SelectedItem {	background-color:#9ACD32; }
        .InsertItem { background-color:#FFFACD;}
    </style>
  </head>
  <body>
    <form id="form1" runat="server">

      <h3>ListView Example</h3>

      <h5>Departments</h5>

      <asp:ListView ID="DepartmentsListView" 
        DataSourceID="DepartmentsDataSource" 
        DataKeyNames="DepartmentID"
        ConvertEmptyStringToNull="true"
        InsertItemPosition="LastItem"
        runat="server">
        <LayoutTemplate>
          <table cellpadding="2" runat="server" id="tblDepartments" width="640px" cellspacing="0">
            <tr runat="server" id="itemPlaceholder" />
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:Button ID="SelectButton" runat="server" Text="Select" CommandName="Select" />
              <asp:Button ID="EditButton" runat="server" Text="Edit" CommandName="Edit" />
            </td>
            <td>
              <asp:Label ID="IDLabel" runat="server" Text='<%#Eval("DepartmentID") %>' />
            </td>
            <td>
              <asp:Label ID="NameLabel" runat="server" Text='<%#Eval("Name") %>' />
            </td>
            <td>
              <asp:Label ID="GroupNameLabel" runat="server" Text='<%#Eval("GroupName") %>' />
            </td>
          </tr>
        </ItemTemplate>
        <SelectedItemTemplate>
          <tr class="SelectedItem" runat="server">
            <td>
              <asp:Button ID="DeleteButton" runat="server" Text="Delete" CommandName="Delete" />
              <asp:Button ID="EditButton" runat="server" Text="Edit" CommandName="Edit" />
            </td>
            <td>
              <asp:Label ID="IDLabel" runat="server" Text='<%#Eval("DepartmentID") %>' />
            </td>
            <td>
              <asp:Label ID="NameLabel" runat="server" Text='<%#Eval("Name") %>' />
            </td>
            <td>
              <asp:Label ID="GroupNameLabel" runat="server" Text='<%#Eval("GroupName") %>' />
            </td>
          </tr>
        </SelectedItemTemplate>
        <EditItemTemplate>
          <tr class="EditItem">
            <td>
              <asp:Button ID="UpdateButton" runat="server" CommandName="Update" Text="Update" />
              <asp:Button ID="CancelButton" runat="server" CommandName="Cancel" Text="Cancel" />
            </td>
            <td>
              <b>ID</b><br />
              <asp:Label ID="IDLabel" runat="server" Text='<%#Eval("DepartmentID") %>' />
            </td>
            <td>
              <asp:Label runat="server" ID="NameLabel" AssociatedControlID="NameTextBox" 
                Text="Name" Font-Bold="true"/><br />
              <asp:TextBox ID="NameTextBox" runat="server" Text='<%#Bind("Name") %>' />
            </td>
            <td>
              <asp:Label runat="server" ID="GroupNameLabel" AssociatedControlID="GroupNameTextBox" 
                Text="Group Name" Font-Bold="true" /><br />
              <asp:TextBox ID="GroupNameTextBox" runat="server" 
                Width="200px"
                Text='<%#Bind("GroupName") %>' />
              <br />
            </td>
          </tr>
        </EditItemTemplate>
        <InsertItemTemplate>
          <tr class="InsertItem">
            <td colspan="2">
              <asp:Button ID="InsertButton" runat="server" CommandName="Insert" Text="Insert" />
              <asp:Button ID="CancelButton" runat="server" CommandName="Cancel" Text="Cancel" />
            </td>
            <td>
              <asp:Label runat="server" ID="NameLabel" AssociatedControlID="NameTextBox" 
                Text="Name" Font-Bold="true"/><br />
              <asp:TextBox ID="NameTextBox" runat="server" Text='<%#Bind("Name") %>' /><br />
            </td>
            <td>
              <asp:Label runat="server" ID="GroupNameLabel" AssociatedControlID="GroupNameTextBox" 
                Text="Group Name" Font-Bold="true" /><br />                
              <asp:TextBox ID="GroupNameTextBox" runat="server" Text='<%#Bind("GroupName") %>' />
            </td>
          </tr>
        </InsertItemTemplate>
      </asp:ListView>

      <!-- This example uses Microsoft SQL Server and connects      -->
      <!-- to the AdventureWorks sample database. Use an ASP.NET    -->
      <!-- expression to retrieve the connection string value       -->
      <!-- from the Web.config file.                                -->            
      <asp:SqlDataSource ID="DepartmentsDataSource" runat="server" 
            ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
            SelectCommand="SELECT DepartmentID, Name, GroupName FROM HumanResources.Department"
            UpdateCommand="UPDATE HumanResources.Department 
                SET Name = @Name, GroupName = @GroupName WHERE (DepartmentID = @DepartmentID)"            
	        DeleteCommand="DELETE FROM HumanResources.Department 
	            WHERE (DepartmentID = @DepartmentID)" 
	        InsertCommand="INSERT INTO HumanResources.Department(Name, GroupName) 
	            VALUES (@Name, @GroupName)">
      </asp:SqlDataSource>

    </form>
  </body>
</html>


<%@ Page language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head id="Head1" runat="server">
    <title>ListView Example</title>
    <style type="text/css">
        .EditItem { background-color:#8FBC8F;}
        .SelectedItem {	background-color:#9ACD32; }
        .InsertItem { background-color:#FFFACD;}
    </style>
  </head>
  <body>
    <form id="form1" runat="server">

      <h3>ListView Example</h3>

      <h5>Departments</h5>

      <asp:ListView ID="DepartmentsListView" 
        DataSourceID="DepartmentsDataSource" 
        DataKeyNames="DepartmentID"
        ConvertEmptyStringToNull="true"
        InsertItemPosition="LastItem"
        runat="server">
        <LayoutTemplate>
          <table cellpadding="2" runat="server" id="tblDepartments" width="640px" cellspacing="0">
            <tr runat="server" id="itemPlaceholder" />
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:Button ID="SelectButton" runat="server" Text="Select" CommandName="Select" />
              <asp:Button ID="EditButton" runat="server" Text="Edit" CommandName="Edit" />
            </td>
            <td>
              <asp:Label ID="IDLabel" runat="server" Text='<%#Eval("DepartmentID") %>' />
            </td>
            <td>
              <asp:Label ID="NameLabel" runat="server" Text='<%#Eval("Name") %>' />
            </td>
            <td>
              <asp:Label ID="GroupNameLabel" runat="server" Text='<%#Eval("GroupName") %>' />
            </td>
          </tr>
        </ItemTemplate>
        <SelectedItemTemplate>
          <tr class="SelectedItem" runat="server">
            <td>
              <asp:Button ID="DeleteButton" runat="server" Text="Delete" CommandName="Delete" />
              <asp:Button ID="EditButton" runat="server" Text="Edit" CommandName="Edit" />
            </td>
            <td>
              <asp:Label ID="IDLabel" runat="server" Text='<%#Eval("DepartmentID") %>' />
            </td>
            <td>
              <asp:Label ID="NameLabel" runat="server" Text='<%#Eval("Name") %>' />
            </td>
            <td>
              <asp:Label ID="GroupNameLabel" runat="server" Text='<%#Eval("GroupName") %>' />
            </td>
          </tr>
        </SelectedItemTemplate>
        <EditItemTemplate>
          <tr class="EditItem">
            <td>
              <asp:Button ID="UpdateButton" runat="server" CommandName="Update" Text="Update" />
              <asp:Button ID="CancelButton" runat="server" CommandName="Cancel" Text="Cancel" />
            </td>
            <td>
              <b>ID</b><br />
              <asp:Label ID="IDLabel" runat="server" Text='<%#Eval("DepartmentID") %>' />
            </td>
            <td>
              <asp:Label runat="server" ID="NameLabel" AssociatedControlID="NameTextBox" 
                Text="Name" Font-Bold="true"/><br />
              <asp:TextBox ID="NameTextBox" runat="server" Text='<%#Bind("Name") %>' />
            </td>
            <td>
              <asp:Label runat="server" ID="GroupNameLabel" AssociatedControlID="GroupNameTextBox" 
                Text="Group Name" Font-Bold="true" /><br />
              <asp:TextBox ID="GroupNameTextBox" runat="server" 
                Width="200px"
                Text='<%#Bind("GroupName") %>' />
              <br />
            </td>
          </tr>
        </EditItemTemplate>
        <InsertItemTemplate>
          <tr class="InsertItem">
            <td colspan="2">
              <asp:Button ID="InsertButton" runat="server" CommandName="Insert" Text="Insert" />
              <asp:Button ID="CancelButton" runat="server" CommandName="Cancel" Text="Cancel" />
            </td>
            <td>
              <asp:Label runat="server" ID="NameLabel" AssociatedControlID="NameTextBox" 
                Text="Name" Font-Bold="true"/><br />
              <asp:TextBox ID="NameTextBox" runat="server" Text='<%#Bind("Name") %>' /><br />
            </td>
            <td>
              <asp:Label runat="server" ID="GroupNameLabel" AssociatedControlID="GroupNameTextBox" 
                Text="Group Name" Font-Bold="true" /><br />                
              <asp:TextBox ID="GroupNameTextBox" runat="server" Text='<%#Bind("GroupName") %>' />
            </td>
          </tr>
        </InsertItemTemplate>
      </asp:ListView>

      <!-- This example uses Microsoft SQL Server and connects      -->
      <!-- to the AdventureWorks sample database. Use an ASP.NET    -->
      <!-- expression to retrieve the connection string value       -->
      <!-- from the Web.config file.                                -->            
      <asp:SqlDataSource ID="DepartmentsDataSource" runat="server" 
            ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
            SelectCommand="SELECT DepartmentID, Name, GroupName FROM HumanResources.Department"
            UpdateCommand="UPDATE HumanResources.Department 
                SET Name = @Name, GroupName = @GroupName WHERE (DepartmentID = @DepartmentID)"            
	        DeleteCommand="DELETE FROM HumanResources.Department 
	            WHERE (DepartmentID = @DepartmentID)" 
	        InsertCommand="INSERT INTO HumanResources.Department(Name, GroupName) 
	            VALUES (@Name, @GroupName)">
      </asp:SqlDataSource>

    </form>
  </body>
</html>

Informazioni sulla versione

.NET Framework

Supportato in: 4, 3.5

Piattaforme

Windows 7, Windows Vista SP1 o versione successiva, Windows XP SP3, Windows Server 2008 (componenti di base del server non supportati), Windows Server 2008 R2 (componenti di base del server supportati con SP1 o versione successiva), Windows Server 2003 SP2

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

Codice thread safe

Qualsiasi membro static (Shared in Visual Basic) pubblico di questo tipo è thread-safe. I membri di istanza non sono garantiti come thread-safe.

Vedere anche

Riferimenti

Spazio dei nomi System.Web.UI.WebControls

LinqDataSource

Altre risorse

Cenni preliminari sul controllo server Web ListView

Cenni preliminari sui controlli server Web ASP.NET con associazione a dati