DataSourceSelectArguments Klasse

Definition

Namespace:

System.Web.UI

Assembly:

System.Web.dll

Stellt datengebundenen Steuerelementen ein Verfahren bereit, um beim Abruf von Daten datenbezogene Vorgänge von Datenquellensteuerelementen anzufordern. Diese Klasse kann nicht vererbt werden.

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 aufgelistet. In der folgenden Tabelle wird angegeben, wie die DataSourceSelectArguments -Klasse diese datenbezogenen Vorgänge unterstützt.

Funktionalität	Verwandte DataSourceSelectArguments-Eigenschaften
DataSourceCapabilities.Sort	SortExpression
DataSourceCapabilities.Page	StartRowIndex, MaximumRows
DataSourceCapabilities.RetrieveTotalRowCount	RetrieveTotalRowCount, TotalRowCount

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 bei Bedarf Daten aus dem Datenquellensteuerelement ab. Da die Select(DataSourceSelectArguments, DataSourceViewSelectCallback) Methode einen DataSourceSelectArguments Parameter akzeptiert, ist das datengebundene Steuerelement für das Erstellen und Verwalten eines DataSourceSelectArguments Objekts und für die Übergabe an die Select(DataSourceSelectArguments, DataSourceViewSelectCallback) -Methode verantwortlich, wenn es Daten aus dem Datenquellensteuerelement abruft.

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 Eigenschaft einer Datenquellensicht CanSort zur Laufzeit und fügen mithilfe der AddSupportedCapabilities(DataSourceCapabilities) -Methode eine DataSourceCapabilities.Sort Funktion hinzu. Als separater Vorgang kann das datengebundene Steuerelement ein sortiertes Resultset von einem Datenquellensteuerelement anfordern, indem es die SortExpression -Eigenschaft für das an die DataSourceSelectArgumentsSelect(DataSourceSelectArguments, DataSourceViewSelectCallback) -Methode übergebene Objekt festlegt.

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

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

Wichtig

Wenn eine der DataSourceSelectArguments Eigenschaften festgelegt ist, aber das aktuell gebundene Datenquellensteuerelement die angeforderte Funktion nicht unterstützt, wird eine InvalidOperationException Ausnahme ausgelöst, wenn die DataSourceSelectArguments.RaiseUnsupportedCapabilitiesError(DataSourceView) Methode aufgerufen wird.

Konstruktoren

DataSourceSelectArguments()	Initialisiert eine neue Standardinstanz der DataSourceSelectArguments-Klasse.
DataSourceSelectArguments(Int32, Int32)	Initialisiert eine neue Instanz der DataSourceSelectArguments-Klasse mit der angegebenen Startposition und Zeilenanzahl für die Rückgabe in Pagingszenarios
DataSourceSelectArguments(String)	Initialisiert eine neue Instanz der DataSourceSelectArguments-Klasse mit dem angegebenen Sortierausdruck
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

Eigenschaften

Empty	Ruft ein DataSourceSelectArguments-Objekt ab, dessen Sortierausdruck auf Empty festgelegt ist
MaximumRows	Ruft einen Wert ab, der die maximale Anzahl von Datenzeilen darstellt, die ein Datenquellensteuerelement bei einem Datenabrufvorgang zurückgibt, oder legt diesen fest
RetrieveTotalRowCount	Ruft einen Wert ab, der angibt, ob ein Datenquellensteuerelement bei einem Datenabrufvorgang die Gesamtzeilenanzahl abrufen soll, oder legt diesen fest
SortExpression	Ruft einen Ausdruck ab, mit dem die Datenquellenansicht die von der Select(DataSourceSelectArguments, DataSourceViewSelectCallback)-Methode abgerufenen Daten sortiert, oder legt diesen fest
StartRowIndex	Ruft einen Wert ab, der die Startposition darstellt, die das Datenquellensteuerelement bei einem Datenabrufvorgang zum Abrufen der Datenzeilen verwenden soll, oder legt diesen fest
TotalRowCount	Ruft die Anzahl von Zeilen ab, die bei einem Datenabrufvorgang abgerufen wird, oder legt diese fest

Methoden

AddSupportedCapabilities(DataSourceCapabilities)	Fügt der DataSourceSelectArguments-Instanz eine Funktion hinzu, anhand derer unterstützte und angeforderte Funktionen verglichen werden
Equals(Object)	Bestimmt, ob die angegebene DataSourceSelectArguments-Instanz gleich der aktuellen Instanz ist
GetHashCode()	Gibt den Hashcode für den DataSourceSelectArguments-Typ zurück
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
RaiseUnsupportedCapabilitiesError(DataSourceView)	Vergleicht die für einen ExecuteSelect(DataSourceSelectArguments)-Vorgang angeforderten Funktionen mit denen, die von einer bestimmten Datenquellenansicht unterstützt werden
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Weitere Informationen

• DataSourceCapabilities