DataSourceSelectArguments DataSourceSelectArguments DataSourceSelectArguments DataSourceSelectArguments Class

Definition

Stellt datengebundenen Steuerelementen ein Verfahren bereit, um beim Abruf von Daten datenbezogene Vorgänge von Datenquellensteuerelementen anzufordern.Provides a mechanism that data-bound controls use to request data-related operations from data source controls when data is retrieved. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

public ref class DataSourceSelectArguments sealed
public sealed class DataSourceSelectArguments
type DataSourceSelectArguments = class
Public NotInheritable Class DataSourceSelectArguments
Vererbung
DataSourceSelectArgumentsDataSourceSelectArgumentsDataSourceSelectArgumentsDataSourceSelectArguments

Hinweise

Daten gebundene Steuerelemente verwenden die DataSourceSelectArguments -Klasse, um anzufordern, dass ein Datenquellen-Steuerelement zusätzliche datenbezogene Vorgänge für ein Resultset ausführt, z. b. das Sortieren der Daten oder die Rückgabe einer bestimmten Teilmenge von Daten.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. Diese datenbezogenen Vorgänge werden von der DataSourceCapabilities -Enumeration aufgelistet.These data-related operations are enumerated by the DataSourceCapabilities enumeration. In der folgenden Tabelle wird angegeben DataSourceSelectArguments , wie diese datenbezogenen Vorgänge von der-Klasse unterstützt werden.The following table indicates how the DataSourceSelectArguments class supports these data-related operations.

FunktionCapability Verwandte DataSourceSelectArguments-EigenschaftenRelated DataSourceSelectArguments properties
DataSourceCapabilities.Sort SortExpression
DataSourceCapabilities.Page StartRowIndex, MaximumRowsStartRowIndex, MaximumRows
DataSourceCapabilities.RetrieveTotalRowCount RetrieveTotalRowCount, TotalRowCountRetrieveTotalRowCount, TotalRowCount

Daten gebundene Steuerelemente rufen explizit die PerformSelect -Methode auf, um Daten zu binden Select(DataSourceSelectArguments, DataSourceViewSelectCallback) , die die-Methode des Datenquellen Steuer Elements aufrufen, dem Sie zugeordnet sind.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. Auf diese Weise Ruft das Daten gebundene Steuerelement bei Bedarf Daten aus dem Datenquellen-Steuerelement ab.In this way, the data-bound control retrieves data from the data source control on demand. Da die Select(DataSourceSelectArguments, DataSourceViewSelectCallback) -Methode einen DataSourceSelectArguments -Parameter akzeptiert, ist das Daten gebundene Steuerelement für das Erstellen und DataSourceSelectArguments Verwalten eines-Objekts und das Select(DataSourceSelectArguments, DataSourceViewSelectCallback) übergeben an die-Methode beim Abrufen von Daten aus dem Datenquellen-Steuerelement zuständig.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 einigen Fällen benötigen Daten gebundene Steuerelemente möglicherweise keine zusätzlichen datenbezogenen Funktionen.In some cases, data-bound controls might not need any additional data-related capabilities. In diesem Fall übergeben Daten gebundene Steuerelemente ein Empty Arguments-Objekt an die Select(DataSourceSelectArguments, DataSourceViewSelectCallback) -Methode.In this case, data-bound controls pass an Empty arguments object to the Select(DataSourceSelectArguments, DataSourceViewSelectCallback) method.

Bei sortierten Resultsets überprüfen Daten gebundene Steuerelemente die- CanSort Eigenschaft einer Datenquellen Sicht zur Laufzeit und fügen mithilfe der AddSupportedCapabilities(DataSourceCapabilities) -Methode eine DataSourceCapabilities.Sort Funktion hinzu.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. Als separater Vorgang kann das Daten gebundene Steuerelement ein sortiertes Resultset aus einem Datenquellen-Steuerelement anfordern, SortExpression indem die- DataSourceSelectArguments Eigenschaft des-Objekts Select(DataSourceSelectArguments, DataSourceViewSelectCallback) festgelegt wird, das an die-Methode weitergegeben wird.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.

Bei Pagingszenarios überprüfen Daten gebundene Steuerelemente die- CanPage Eigenschaft einer Datenquellen Sicht zur Laufzeit und fügen mithilfe der AddSupportedCapabilities(DataSourceCapabilities) -Methode eine DataSourceCapabilities.Page Funktion hinzu.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. Als separater Vorgang kann das Daten gebundene Steuerelement eine Teilmenge der Daten aus einem Datenquellen-Steuerelement für das Paging anfordern, indem StartRowIndex die-Eigenschaft und DataSourceSelectArguments die-Eigenschaft für Select(DataSourceSelectArguments, DataSourceViewSelectCallback) das an die-Methode übergebenen- MaximumRows Objekt festgelegt werden.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.

Zum Abrufen der Gesamtanzahl der Zeilen für Auslagerungs Szenarien überprüfen Daten gebundene Steuerelemente die-Eigenschaft CanRetrieveTotalRowCount einer Datenquellen Sicht zur Laufzeit und fügen DataSourceCapabilities.RetrieveTotalRowCount mithilfe der AddSupportedCapabilities(DataSourceCapabilities) -Methode eine Funktion hinzu.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. Als separater Vorgang kann das Daten gebundene Steuerelement eine Gesamt Zeilen Anzahl aus einem Datenquellen-Steuerelement für das Paging anfordern, indem RetrieveTotalRowCount die-Eigenschaft DataSourceSelectArguments für das-Objekt Select(DataSourceSelectArguments, DataSourceViewSelectCallback) festgelegt wird, das an die-Methode übergeben wird.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. Wenn die Select(DataSourceSelectArguments, DataSourceViewSelectCallback) -Methode zurückgibt, ist die Gesamtanzahl der Zeilen TotalRowCount in der-Eigenschaft enthalten.When the Select(DataSourceSelectArguments, DataSourceViewSelectCallback) method returns, the total row count is contained by the TotalRowCount property.

Wichtig

Wenn eine der DataSourceSelectArguments Eigenschaften festgelegt ist, das gegenwärtig gebundene Datenquellen-Steuerelement jedoch die angeforderte Funktion nicht unterstützt, wird beim Aufrufen DataSourceSelectArguments.RaiseUnsupportedCapabilitiesError(DataSourceView) der-Methode eine InvalidOperationException Ausnahme ausgelöst.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.

Konstruktoren

DataSourceSelectArguments() DataSourceSelectArguments() DataSourceSelectArguments() DataSourceSelectArguments()

Initialisiert eine neue Standardinstanz der DataSourceSelectArguments-Klasse.Initializes a new default instance of the DataSourceSelectArguments class.

DataSourceSelectArguments(Int32, Int32) DataSourceSelectArguments(Int32, Int32) DataSourceSelectArguments(Int32, Int32) DataSourceSelectArguments(Int32, Int32)

Initialisiert eine neue Instanz der DataSourceSelectArguments-Klasse mit der angegebenen Startposition und Zeilenanzahl für die Rückgabe in PagingszenariosInitializes a new instance of the DataSourceSelectArguments class with the specified starting position and number of rows to return for paging scenarios.

DataSourceSelectArguments(String) DataSourceSelectArguments(String) DataSourceSelectArguments(String) DataSourceSelectArguments(String)

Initialisiert eine neue Instanz der DataSourceSelectArguments-Klasse mit dem angegebenen SortierausdruckInitializes a new instance of the DataSourceSelectArguments class with the specified sort expression.

DataSourceSelectArguments(String, Int32, Int32) DataSourceSelectArguments(String, Int32, Int32) DataSourceSelectArguments(String, Int32, Int32) DataSourceSelectArguments(String, Int32, Int32)

Initialisiert eine neue Instanz der DataSourceSelectArguments-Klasse mit dem angegebenen Sortierausdruck sowie der angegebenen Startposition und Zeilenanzahl für die Rückgabe in Pagingszenarios.Initializes a new instance of the DataSourceSelectArguments class with the specified sort expression, starting position, and number of rows to return for paging scenarios.

Eigenschaften

Empty Empty Empty Empty

Ruft ein DataSourceSelectArguments-Objekt ab, dessen Sortierausdruck auf Empty festgelegt istGets a DataSourceSelectArguments object with the sort expression set to Empty.

MaximumRows MaximumRows MaximumRows MaximumRows

Ruft einen Wert ab, der die maximale Anzahl von Datenzeilen darstellt, die ein Datenquellensteuerelement bei einem Datenabrufvorgang zurückgibt, oder legt diesen fest.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 RetrieveTotalRowCount RetrieveTotalRowCount RetrieveTotalRowCount

Ruft einen Wert ab, der angibt, ob ein Datenquellensteuerelement bei einem Datenabrufvorgang die Gesamtzeilenanzahl abrufen soll, oder legt diesen fest.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 SortExpression SortExpression SortExpression

Ruft einen Ausdruck ab, mit dem die Datenquellenansicht die von der Select(DataSourceSelectArguments, DataSourceViewSelectCallback)-Methode abgerufenen Daten sortiert, oder legt diesen festGets or sets an expression that the data source view uses to sort the data retrieved by the Select(DataSourceSelectArguments, DataSourceViewSelectCallback) method.

StartRowIndex StartRowIndex StartRowIndex StartRowIndex

Ruft einen Wert ab, der die Startposition darstellt, die das Datenquellensteuerelement bei einem Datenabrufvorgang zum Abrufen der Datenzeilen verwenden soll, oder legt diesen festGets 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 TotalRowCount TotalRowCount TotalRowCount

Ruft die Anzahl von Zeilen ab, die bei einem Datenabrufvorgang abgerufen wird, oder legt diese festGets or sets the number of rows retrieved during a data retrieval operation.

Methoden

AddSupportedCapabilities(DataSourceCapabilities) AddSupportedCapabilities(DataSourceCapabilities) AddSupportedCapabilities(DataSourceCapabilities) AddSupportedCapabilities(DataSourceCapabilities)

Fügt der DataSourceSelectArguments-Instanz eine Funktion hinzu, anhand derer unterstützte und angeforderte Funktionen verglichen werdenAdds one capability to the DataSourceSelectArguments instance, which is used to compare supported capabilities and requested capabilities.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob die angegebene DataSourceSelectArguments-Instanz gleich der aktuellen Instanz istDetermines whether the specified DataSourceSelectArguments instance is equal to the current instance.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Gibt den Hashcode für den DataSourceSelectArguments-Typ zurückReturns the hash code for the DataSourceSelectArguments type.

GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
RaiseUnsupportedCapabilitiesError(DataSourceView) RaiseUnsupportedCapabilitiesError(DataSourceView) RaiseUnsupportedCapabilitiesError(DataSourceView) RaiseUnsupportedCapabilitiesError(DataSourceView)

Vergleicht die für einen ExecuteSelect(DataSourceSelectArguments)-Vorgang angeforderten Funktionen mit denen, die von einer bestimmten Datenquellenansicht unterstützt werdenCompares the capabilities requested for an ExecuteSelect(DataSourceSelectArguments) operation against those that the specified data source view supports.

ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Gilt für:

Siehe auch