DataSourceSelectArguments Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 sealedpublic sealed class DataSourceSelectArgumentstype DataSourceSelectArguments = classPublic 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) |
