DataSourceSelectArguments Klasse

Definition

Namespace:

System.Web.UI

Assembly:

System.Web.dll

Stellt einen Mechanismus bereit, mit dem datengebundene Steuerelemente datenbezogene Vorgänge von Datenquellensteuerelementen anfordern, wenn Daten abgerufen werden. Diese Klasse kann nicht geerbt 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 aufgezählt. Die folgende Tabelle gibt an, wie die DataSourceSelectArguments-Klasse diese datenbezogenen Vorgänge unterstützt.

Fähigkeit	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 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.

Wichtig

Wenn eine der DataSourceSelectArguments-Eigenschaften festgelegt ist, das derzeit gebundene Datenquellensteuerelement die angeforderte Funktion jedoch 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 der Anzahl der Zeilen, die für Pagingszenarien zurückgegeben werden sollen.
DataSourceSelectArguments(String, Int32, Int32)	Initialisiert eine neue Instanz der DataSourceSelectArguments Klasse mit dem angegebenen Sortierausdruck, der Startposition und der Anzahl der Zeilen, die für Pagingszenarien zurückgegeben werden sollen.
DataSourceSelectArguments(String)	Initialisiert eine neue Instanz der DataSourceSelectArguments Klasse mit dem angegebenen Sortierausdruck.

Eigenschaften

Empty	Ruft ein DataSourceSelectArguments -Objekt ab, wobei der Sortierausdruck auf Emptyfestgelegt ist.
MaximumRows	Dient zum Abrufen oder Festlegen eines Werts, der die maximale Anzahl von Datenzeilen darstellt, die ein Datenquellensteuerelement für einen Datenempfangsvorgang zurückgibt.
RetrieveTotalRowCount	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob ein Datenquellensteuerelement während eines Datenempfangsvorgangs eine Anzahl aller Datenzeilen abrufen soll.
SortExpression	Dient zum Abrufen oder Festlegen eines Ausdrucks, den die Datenquellenansicht verwendet, um die von der Select(DataSourceSelectArguments, DataSourceViewSelectCallback) Methode abgerufenen Daten zu sortieren.
StartRowIndex	Dient zum Abrufen oder Festlegen eines Werts, der die Startposition darstellt, die das Datenquellensteuerelement beim Abrufen von Datenzeilen während eines Datenempfangsvorgangs verwenden soll.
TotalRowCount	Ruft die Anzahl der Zeilen ab, die während eines Datenempfangsvorgangs abgerufen werden, oder legt diese fest.

Methoden

AddSupportedCapabilities(DataSourceCapabilities)	Fügt der DataSourceSelectArguments Instanz eine Funktion hinzu, die verwendet wird, um unterstützte Funktionen und angeforderte Funktionen zu vergleichen.
Equals(Object)	Bestimmt, ob die angegebene DataSourceSelectArguments Instanz der aktuellen Instanz entspricht.
GetHashCode()	Gibt den Hashcode für den DataSourceSelectArguments Typ zurück.
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
RaiseUnsupportedCapabilitiesError(DataSourceView)	Vergleicht die für einen ExecuteSelect(DataSourceSelectArguments) Vorgang angeforderten Funktionen mit denen, die die angegebene Datenquellenansicht unterstützt.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Weitere Informationen

• DataSourceCapabilities