DataSourceSelectArguments Klasse

Definition

public ref class DataSourceSelectArguments sealed

public sealed class DataSourceSelectArguments

type DataSourceSelectArguments = class

Public NotInheritable Class DataSourceSelectArguments

Vererbung

Object

DataSourceSelectArguments

Hinweise

Datengebundene Steuerelemente verwenden die DataSourceSelectArguments Klasse, um anzufordern, dass ein Datenquellensteuerelement zusätzliche datenbezogene Vorgänge für ein Resultset ausführt, z. B. das Sortieren der Daten oder das Zurückgeben einer bestimmten Teilmenge von Daten. Diese datenbezogenen Vorgänge werden von der DataSourceCapabilities Enumeration aufgezählt. Die folgende Tabelle gibt an, wie die DataSourceSelectArguments-Klasse diese datenbezogenen Vorgänge unterstützt.

Datengebundene Steuerelemente rufen explizit die PerformSelect Methode zum Binden von Daten auf, wodurch die Select(DataSourceSelectArguments, DataSourceViewSelectCallback) Methode des Datenquellensteuerelements aufgerufen wird, dem sie zugeordnet sind. Auf diese Weise ruft das datengebundene Steuerelement Daten aus dem Datenquellensteuerelement bei Bedarf ab. Da die Select(DataSourceSelectArguments, DataSourceViewSelectCallback)-Methode einen DataSourceSelectArguments-Parameter akzeptiert, ist das datengebundene Steuerelement für das Erstellen und Verwalten eines DataSourceSelectArguments Objekts verantwortlich und übergibt es an die Select(DataSourceSelectArguments, DataSourceViewSelectCallback)-Methode, wenn daten aus dem Datenquellensteuerelement abgerufen werden.

In einigen Fällen benötigen datengebundene Steuerelemente möglicherweise keine zusätzlichen datenbezogenen Funktionen. In diesem Fall übergeben datengebundene Steuerelemente ein Empty Argumentobjekt an die Select(DataSourceSelectArguments, DataSourceViewSelectCallback)-Methode.

Bei sortierten Resultsets überprüfen datengebundene Steuerelemente die CanSort Eigenschaft einer Datenquellenansicht zur Laufzeit, und fügen Sie mithilfe der AddSupportedCapabilities(DataSourceCapabilities)-Methode eine DataSourceCapabilities.Sort-Funktion hinzu. Als separater Vorgang kann das datengebundene Steuerelement ein sortiertes Resultset aus einem Datenquellensteuerelement anfordern, indem die SortExpression-Eigenschaft für das an die Select(DataSourceSelectArguments, DataSourceViewSelectCallback) Methode übergebene DataSourceSelectArguments-Objekt festgelegt wird.

Bei Auslagerungsszenarien überprüfen datengebundene Steuerelemente die CanPage Eigenschaft einer Datenquellenansicht zur Laufzeit, und fügen Sie mithilfe der AddSupportedCapabilities(DataSourceCapabilities)-Methode eine DataSourceCapabilities.Page-Funktion hinzu. Als separater Vorgang kann das datengebundene Steuerelement eine Teilmenge von Daten aus einem Datenquellensteuerelement für die Auslagerung anfordern, indem die eigenschaften StartRowIndex und MaximumRows für das an die Select(DataSourceSelectArguments, DataSourceViewSelectCallback) Methode übergebene DataSourceSelectArguments-Objekt festgelegt werden.

Um eine Gesamtzeilenanzahl für Pagingszenarien abzurufen, überprüfen datengebundene Steuerelemente die CanRetrieveTotalRowCount Eigenschaft einer Datenquelle zur Laufzeit und fügen eine DataSourceCapabilities.RetrieveTotalRowCount-Funktion mithilfe der AddSupportedCapabilities(DataSourceCapabilities)-Methode hinzu. Als separater Vorgang kann das datengebundene Steuerelement eine Gesamtzeilenanzahl von einem Datenquellensteuerelement für die Auslagerung anfordern, indem die RetrieveTotalRowCount-Eigenschaft für das an die Select(DataSourceSelectArguments, DataSourceViewSelectCallback) Methode übergebene DataSourceSelectArguments-Objekt festgelegt wird. Wenn die Select(DataSourceSelectArguments, DataSourceViewSelectCallback)-Methode zurückgegeben wird, ist die Gesamtzahl der Zeilen in der eigenschaft TotalRowCount enthalten.

Konstruktoren

Eigenschaften

Methoden

Gilt für:

Weitere Informationen

• DataSourceCapabilities