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.Provides a mechanism that data-bound controls use to request data-related operations from data source controls when data is retrieved. Questa classe non può essere ereditata.This class cannot be inherited.

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

Commenti

I controlli associati a dati utilizzano DataSourceSelectArguments la classe per richiedere che un controllo origine dati esegua operazioni aggiuntive correlate ai dati su un set di risultati, ad esempio l'ordinamento dei dati o la restituzione di un subset di dati specifico.Data-bound controls use the DataSourceSelectArguments class to request that a data source control performs additional data-related operations on a result set, such as sorting the data or returning a specific subset of data. Queste operazioni correlate ai DataSourceCapabilities dati vengono enumerate dall'enumerazione.These data-related operations are enumerated by the DataSourceCapabilities enumeration. La tabella seguente indica il modo DataSourceSelectArguments in cui la classe supporta queste operazioni correlate ai dati.The following table indicates how the DataSourceSelectArguments class supports these data-related operations.

FunzionalitàCapability Proprietà di DataSourceSelectArguments correlateRelated DataSourceSelectArguments properties
DataSourceCapabilities.Sort SortExpression
DataSourceCapabilities.Page StartRowIndex, MaximumRowsStartRowIndex, MaximumRows
DataSourceCapabilities.RetrieveTotalRowCount RetrieveTotalRowCount, TotalRowCountRetrieveTotalRowCount, TotalRowCount

I controlli con associazione a dati chiamano in PerformSelect modo esplicito il metodo per associare i Select(DataSourceSelectArguments, DataSourceViewSelectCallback) dati, che chiama il metodo del controllo origine dati a cui sono associati.Data-bound controls explicitly call the PerformSelect method to bind data, which calls the Select(DataSourceSelectArguments, DataSourceViewSelectCallback) method of the data source control they are associated with. In questo modo, il controllo con associazione a dati recupera i dati dal controllo origine dati su richiesta.In this way, the data-bound control retrieves data from the data source control on demand. Poiché il Select(DataSourceSelectArguments, DataSourceViewSelectCallback) metodo accetta un DataSourceSelectArguments parametro, il controllo con associazione a dati è responsabile della creazione e della DataSourceSelectArguments gestione di un oggetto e del Select(DataSourceSelectArguments, DataSourceViewSelectCallback) relativo passaggio al metodo quando recupera i dati dal controllo origine dati.Because the Select(DataSourceSelectArguments, DataSourceViewSelectCallback) method accepts a DataSourceSelectArguments parameter, the data-bound control is responsible for creating and managing a DataSourceSelectArguments object and passing it to the Select(DataSourceSelectArguments, DataSourceViewSelectCallback) method when it retrieves data from the data source control.

In alcuni casi, i controlli con associazione a dati potrebbero non richiedere ulteriori funzionalità correlate ai dati.In some cases, data-bound controls might not need any additional data-related capabilities. In questo caso, i Empty Select(DataSourceSelectArguments, DataSourceViewSelectCallback) controlli con associazione a dati passano un oggetto arguments al metodo.In this case, data-bound controls pass an Empty arguments object to the Select(DataSourceSelectArguments, DataSourceViewSelectCallback) method.

Per i set di risultati ordinati, i controlli con associazione a dati controllano CanSort la proprietà di una vista origine dati in DataSourceCapabilities.Sort fase di esecuzione AddSupportedCapabilities(DataSourceCapabilities) e aggiungono una funzionalità usando il metodo.For sorted result sets, data-bound controls check a data source view's CanSort property at run time, and add a DataSourceCapabilities.Sort capability using the AddSupportedCapabilities(DataSourceCapabilities) method. Come operazione separata, il controllo con associazione a dati può richiedere un set di risultati ordinato da un controllo origine dati impostando SortExpression la proprietà DataSourceSelectArguments sull'oggetto passato al Select(DataSourceSelectArguments, DataSourceViewSelectCallback) metodo.As a separate operation, the data-bound control can request a sorted result set from a data source control by setting the SortExpression property on the DataSourceSelectArguments object passed to the Select(DataSourceSelectArguments, DataSourceViewSelectCallback) method.

Per gli scenari di paging, i controlli associati a dati controllano la CanPage proprietà di una vista origine dati in fase DataSourceCapabilities.Page di esecuzione e AddSupportedCapabilities(DataSourceCapabilities) aggiungono una funzionalità usando il metodo.For paging scenarios, data-bound controls check a data source view's CanPage property at run time, and add a DataSourceCapabilities.Page capability using the AddSupportedCapabilities(DataSourceCapabilities) method. Come operazione separata, il controllo con associazione a dati può richiedere un subset di dati da un controllo origine dati per il paging impostando StartRowIndex le MaximumRows proprietà e sull' DataSourceSelectArguments oggetto passato al Select(DataSourceSelectArguments, DataSourceViewSelectCallback) metodo.As a separate operation, the data-bound control can request a subset of data from a data source control for paging by setting the StartRowIndex and MaximumRows properties on the DataSourceSelectArguments object passed to the Select(DataSourceSelectArguments, DataSourceViewSelectCallback) method.

Per recuperare un conteggio totale delle righe per gli scenari di paging, i controlli associati a dati controllano CanRetrieveTotalRowCount la proprietà di una vista origine dati in DataSourceCapabilities.RetrieveTotalRowCount fase di esecuzione AddSupportedCapabilities(DataSourceCapabilities) e aggiungono una funzionalità usando il metodo.To retrieve a total row count for paging scenarios, data-bound controls check a data source view's CanRetrieveTotalRowCount property at run time, and add a DataSourceCapabilities.RetrieveTotalRowCount capability using the AddSupportedCapabilities(DataSourceCapabilities) method. Come operazione separata, il controllo con associazione a dati può richiedere un numero totale di righe da un controllo origine dati per il paging impostando la RetrieveTotalRowCount proprietà DataSourceSelectArguments sull'oggetto passato al Select(DataSourceSelectArguments, DataSourceViewSelectCallback) metodo.As a separate operation, the data-bound control can request a total row count from a data source control for paging by setting the RetrieveTotalRowCount property on the DataSourceSelectArguments object passed to the Select(DataSourceSelectArguments, DataSourceViewSelectCallback) method. Quando il Select(DataSourceSelectArguments, DataSourceViewSelectCallback) metodo restituisce un risultato, il conteggio totale delle righe è TotalRowCount contenuto nella proprietà.When the Select(DataSourceSelectArguments, DataSourceViewSelectCallback) method returns, the total row count is contained by the TotalRowCount property.

Importante

Se una delle DataSourceSelectArguments proprietà è impostata, ma il controllo origine dati attualmente associato non supporta la funzionalità richiesta, viene generata un' InvalidOperationException eccezione quando viene chiamato il DataSourceSelectArguments.RaiseUnsupportedCapabilitiesError(DataSourceView) metodo.If any of the DataSourceSelectArguments properties are set, but the currently bound data source control does not support the requested capability, an InvalidOperationException exception is thrown when the DataSourceSelectArguments.RaiseUnsupportedCapabilitiesError(DataSourceView) method is called.

Costruttori

DataSourceSelectArguments()

Inizializza una nuova istanza predefinita della classe DataSourceSelectArguments.Initializes a new default instance of the DataSourceSelectArguments class.

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.Initializes a new instance of the DataSourceSelectArguments class with the specified starting position and number of rows to return for paging scenarios.

DataSourceSelectArguments(String)

Inizializza una nuova istanza della classe DataSourceSelectArguments con l'espressione di ordinamento specificata.Initializes a new instance of the DataSourceSelectArguments class with the specified sort expression.

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.Initializes a new instance of the DataSourceSelectArguments class with the specified sort expression, starting position, and number of rows to return for paging scenarios.

Proprietà

Empty

Ottiene un oggetto DataSourceSelectArguments con l'espressione di ordinamento impostata su Empty.Gets a DataSourceSelectArguments object with the sort expression set to 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.Gets or sets a value that represents the maximum number of data rows that a data source control returns for a data retrieval operation.

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.Gets or sets a value indicating whether a data source control should retrieve a count of all the data rows during a data retrieval operation.

SortExpression

Ottiene o imposta un'espressione utilizzata dalla visualizzazione origine dati per ordinare i dati recuperati tramite il metodo Select(DataSourceSelectArguments, DataSourceViewSelectCallback).Gets or sets an expression that the data source view uses to sort the data retrieved by the Select(DataSourceSelectArguments, DataSourceViewSelectCallback) method.

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.Gets or sets a value that represents the starting position the data source control should use when retrieving data rows during a data retrieval operation.

TotalRowCount

Ottiene o imposta il numero di righe recuperate durante un'operazione di recupero dati.Gets or sets the number of rows retrieved during a data retrieval operation.

Metodi

AddSupportedCapabilities(DataSourceCapabilities)

Aggiunge una funzionalità all'istanza DataSourceSelectArguments, che viene utilizzata per eseguire un confronto tra le funzionalità supportate e quelle richieste.Adds one capability to the DataSourceSelectArguments instance, which is used to compare supported capabilities and requested capabilities.

Equals(Object)

Determina se l'istanza DataSourceSelectArguments specificata è uguale all'istanza corrente.Determines whether the specified DataSourceSelectArguments instance is equal to the current instance.

GetHashCode()

Restituisce il codice hash per questo tipo DataSourceSelectArguments.Returns the hash code for the DataSourceSelectArguments type.

GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
RaiseUnsupportedCapabilitiesError(DataSourceView)

Confronta le funzionalità richieste per un'operazione ExecuteSelect(DataSourceSelectArguments) con quelle supportate dalla visualizzazione origine dati specificata.Compares the capabilities requested for an ExecuteSelect(DataSourceSelectArguments) operation against those that the specified data source view supports.

ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)

Si applica a

Vedi anche