DataSourceSelectArguments Classe

Definizione

Fornisce un meccanismo utilizzato dai controlli con associazione a dati per richiedere l'esecuzione di operazioni correlate a dati da parte di controlli origine dati durante il recupero dei dati. La classe non può essere ereditata.

public ref class DataSourceSelectArguments sealed
public sealed class DataSourceSelectArguments
type DataSourceSelectArguments = class
Public NotInheritable Class DataSourceSelectArguments
Ereditarietà
DataSourceSelectArguments

Commenti

I controlli associati ai dati usano la classe per richiedere che un controllo origine dati esegue operazioni aggiuntive correlate ai dati in un set di risultati, ad esempio l'ordinamento DataSourceSelectArguments 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.

Funzionalità Proprietà Relative a DataSourceSelectArguments
DataSourceCapabilities.Sort SortExpression
DataSourceCapabilities.Page StartRowIndex, MaximumRows
DataSourceCapabilities.RetrieveTotalRowCount RetrieveTotalRowCount, TotalRowCount

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

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

Per i set di risultati ordinati, i controlli associati ai 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 ai 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 ai 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 ai 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 ai 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 ai dati può richiedere un numero 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 metodo restituisce, il Select(DataSourceSelectArguments, DataSourceViewSelectCallback) numero totale di righe è contenuto dalla 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

DataSourceSelectArguments()

Inizializza una nuova istanza predefinita della classe DataSourceSelectArguments.

DataSourceSelectArguments(Int32, Int32)

Inizializza una nuova istanza della classe DataSourceSelectArguments con la posizione iniziale e il numero di righe specificati da restituire per gli scenari di spostamento.

DataSourceSelectArguments(String)

Inizializza una nuova istanza della classe DataSourceSelectArguments con l'espressione di ordinamento specificata.

DataSourceSelectArguments(String, Int32, Int32)

Inizializza una nuova istanza della classe DataSourceSelectArguments con l'espressione di ordinamento, la posizione iniziale e il numero di righe specificati da restituire per gli scenari di spostamento.

Proprietà

Empty

Ottiene un oggetto DataSourceSelectArguments con l'espressione di ordinamento impostata su Empty.

MaximumRows

Ottiene o imposta un valore che rappresenta il numero massimo di righe di dati restituito 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 il numero totale di righe di dati durante un'operazione di recupero dati.

SortExpression

Ottiene o imposta un'espressione utilizzata dalla visualizzazione origine dati per ordinare i dati recuperati tramite il metodo Select(DataSourceSelectArguments, DataSourceViewSelectCallback).

StartRowIndex

Ottiene o imposta un valore che rappresenta la posizione iniziale utilizzata dal controllo origine dati per il recupero delle 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

AddSupportedCapabilities(DataSourceCapabilities)

Aggiunge una funzionalità all'istanza DataSourceSelectArguments, che viene utilizzata per eseguire un confronto tra le funzionalità supportate e quelle richieste.

Equals(Object)

Determina se l'istanza DataSourceSelectArguments specificata è uguale all'istanza corrente.

GetHashCode()

Restituisce il codice hash per questo tipo DataSourceSelectArguments.

GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
RaiseUnsupportedCapabilitiesError(DataSourceView)

Confronta le funzionalità richieste per un'operazione ExecuteSelect(DataSourceSelectArguments) con quelle supportate dalla visualizzazione origine dati specificata.

ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Si applica a

Vedi anche