DataSourceSelectArguments Classe

Definizione

Spazio dei nomi:

System.Web.UI

Assembly:

System.Web.dll

Fornisce un meccanismo che i controlli associati a dati usano per richiedere operazioni correlate ai dati dai controlli dell'origine dati quando vengono recuperati i dati. Questa classe non può essere ereditata.

public ref class DataSourceSelectArguments sealed

public sealed class DataSourceSelectArguments

type DataSourceSelectArguments = class

Public NotInheritable Class DataSourceSelectArguments

Ereditarietà

Object

DataSourceSelectArguments

Commenti

I controlli associati a dati usano la DataSourceSelectArguments classe per richiedere che un controllo origine dati esegua operazioni aggiuntive correlate ai dati in un set di risultati, ad esempio l'ordinamento dei dati o la restituzione di un subset specifico di dati. Queste operazioni correlate ai dati vengono enumerate dall'enumerazione DataSourceCapabilities . La tabella seguente indica come la DataSourceSelectArguments classe supporta queste operazioni correlate ai dati.

Capability	Proprietà correlate DataSourceSelectArguments
DataSourceCapabilities.Sort	SortExpression
DataSourceCapabilities.Page	StartRowIndex, MaximumRows
DataSourceCapabilities.RetrieveTotalRowCount	RetrieveTotalRowCount, TotalRowCount

I controlli associati a dati chiamano in modo esplicito il PerformSelect metodo per associare i dati, che chiama il Select(DataSourceSelectArguments, DataSourceViewSelectCallback) metodo del controllo origine dati a cui sono associati. In questo modo, il controllo associato a dati recupera i dati dal controllo origine dati su richiesta. Poiché il Select(DataSourceSelectArguments, DataSourceViewSelectCallback) metodo accetta un DataSourceSelectArguments parametro, il controllo associato a dati è responsabile della creazione e della gestione di un DataSourceSelectArguments oggetto e del passaggio al Select(DataSourceSelectArguments, DataSourceViewSelectCallback) metodo quando recupera i dati dal controllo origine dati.

In alcuni casi, i controlli associati a dati potrebbero non richiedere funzionalità aggiuntive correlate ai dati. In questo caso, i controlli associati a dati passano un Empty oggetto argomenti al Select(DataSourceSelectArguments, DataSourceViewSelectCallback) metodo .

Per i set di risultati ordinati, i controlli associati a dati controllano la proprietà di una vista origine dati in fase di CanSort esecuzione e aggiungono una DataSourceCapabilities.Sort funzionalità usando il AddSupportedCapabilities(DataSourceCapabilities) metodo . Come operazione separata, il controllo associato a dati può richiedere un set di risultati ordinato da un controllo origine dati impostando la SortExpression proprietà sull'oggetto DataSourceSelectArguments passato al Select(DataSourceSelectArguments, DataSourceViewSelectCallback) metodo .

Per gli scenari di paging, i controlli associati a dati controllano la proprietà di una vista origine dati in fase di CanPage esecuzione e aggiungono una DataSourceCapabilities.Page funzionalità usando il AddSupportedCapabilities(DataSourceCapabilities) metodo . Come operazione separata, il controllo associato a dati può richiedere un subset di dati da un controllo origine dati per il paging impostando le StartRowIndex proprietà e MaximumRows sull'oggetto DataSourceSelectArguments passato al Select(DataSourceSelectArguments, DataSourceViewSelectCallback) metodo .

Per recuperare un numero totale di righe per gli scenari di paging, i controlli associati a dati controllano la proprietà di una vista origine dati in fase di CanRetrieveTotalRowCount esecuzione e aggiungono una DataSourceCapabilities.RetrieveTotalRowCount funzionalità usando il AddSupportedCapabilities(DataSourceCapabilities) metodo . Come operazione separata, il controllo associato a dati può richiedere un conteggio totale di righe da un controllo origine dati per il paging impostando la RetrieveTotalRowCount proprietà sull'oggetto DataSourceSelectArguments passato al Select(DataSourceSelectArguments, DataSourceViewSelectCallback) metodo . Quando il Select(DataSourceSelectArguments, DataSourceViewSelectCallback) metodo termina, il numero totale di righe è contenuto nella TotalRowCount proprietà .

Importante

Se una delle DataSourceSelectArguments proprietà è impostata, ma il controllo origine dati attualmente associato non supporta la funzionalità richiesta, viene generata un'eccezione InvalidOperationException quando viene chiamato il DataSourceSelectArguments.RaiseUnsupportedCapabilitiesError(DataSourceView) metodo .

Costruttori

Nome	Descrizione
DataSourceSelectArguments()	Inizializza una nuova istanza predefinita della DataSourceSelectArguments classe .
DataSourceSelectArguments(Int32, Int32)	Inizializza una nuova istanza della DataSourceSelectArguments classe con la posizione iniziale specificata e il numero di righe da restituire per gli scenari di paging.
DataSourceSelectArguments(String, Int32, Int32)	Inizializza una nuova istanza della DataSourceSelectArguments classe con l'espressione di ordinamento, la posizione iniziale e il numero di righe da restituire per gli scenari di paging.
DataSourceSelectArguments(String)	Inizializza una nuova istanza della DataSourceSelectArguments classe con l'espressione di ordinamento specificata.

Proprietà

Nome	Descrizione
Empty	Ottiene un DataSourceSelectArguments oggetto con l'espressione di ordinamento impostata su Empty.
MaximumRows	Ottiene o imposta un valore che rappresenta il numero massimo di righe di dati restituite da un controllo origine dati per un'operazione di recupero dati.
RetrieveTotalRowCount	Ottiene o imposta un valore che indica se un controllo origine dati deve recuperare un conteggio di tutte le righe di dati durante un'operazione di recupero dati.
SortExpression	Ottiene o imposta un'espressione utilizzata dalla vista origine dati per ordinare i dati recuperati dal Select(DataSourceSelectArguments, DataSourceViewSelectCallback) metodo .
StartRowIndex	Ottiene o imposta un valore che rappresenta la posizione iniziale che il controllo origine dati deve utilizzare durante il recupero di righe di dati durante un'operazione di recupero dati.
TotalRowCount	Ottiene o imposta il numero di righe recuperate durante un'operazione di recupero dati.

Metodi

Nome	Descrizione
AddSupportedCapabilities(DataSourceCapabilities)	Aggiunge una funzionalità all'istanza DataSourceSelectArguments , usata per confrontare le funzionalità supportate e le funzionalità richieste.
Equals(Object)	Determina se l'istanza specificata DataSourceSelectArguments è uguale all'istanza corrente.
GetHashCode()	Restituisce il codice hash per il DataSourceSelectArguments tipo.
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
RaiseUnsupportedCapabilitiesError(DataSourceView)	Confronta le funzionalità richieste per un'operazione ExecuteSelect(DataSourceSelectArguments) con quelle supportate dalla vista origine dati specificata.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Vedi anche

• DataSourceCapabilities