Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

DataSourceSelectArguments-Klasse

 

Veröffentlicht: Oktober 2016

Stellt einen Mechanismus, mit denen datengebundene Steuerelemente datenbezogene Vorgänge beim Abrufen von Daten aus einem Datenquellensteuerelement anzufordern. Diese Klasse kann nicht vererbt werden.

Namespace:   System.Web.UI
Assembly:  System.Web (in System.Web.dll)

System.Object
  System.Web.UI.DataSourceSelectArguments

public sealed class DataSourceSelectArguments

NameBeschreibung
System_CAPS_pubmethodDataSourceSelectArguments()

Initialisiert eine neue Standardinstanz der DataSourceSelectArguments-Klasse.

System_CAPS_pubmethodDataSourceSelectArguments(Int32, Int32)

Initialisiert eine neue Instanz der DataSourceSelectArguments -Klasse mit der angegebenen Anfangsposition und die Anzahl der Zeilen von Paging zurückgegeben.

System_CAPS_pubmethodDataSourceSelectArguments(String)

Initialisiert eine neue Instanz der DataSourceSelectArguments -Klasse mit dem angegebenen Sortierausdruck.

System_CAPS_pubmethodDataSourceSelectArguments(String, Int32, Int32)

Initialisiert eine neue Instanz der DataSourceSelectArguments -Klasse mit der angegebenen Sortierausdruck Anfangsposition und Anzahl von Zeilen von Paging zurückgegeben.

NameBeschreibung
System_CAPS_pubpropertySystem_CAPS_staticEmpty

Ruft ein DataSourceSelectArguments -Objekt mit den Sortierausdruck festgelegt Empty.

System_CAPS_pubpropertyMaximumRows

Ruft ab oder legt einen Wert, der die maximale Anzahl von Datenzeilen darstellt, die ein Datenquellen-Steuerelement für einen Vorgang zum Abrufen von Daten zurückgibt.

System_CAPS_pubpropertyRetrieveTotalRowCount

Ruft ab oder legt einen Wert, der angibt, ob die Anzahl der Datenzeilen ein Datenquellensteuerelement bei einem Vorgang zum Abrufen von Daten abgerufen werden sollen.

System_CAPS_pubpropertySortExpression

Ruft ab oder legt einen Ausdruck, der die Datenquellensicht wird verwendet, um die Daten abgerufen, indem die DataSourceView.Select(DataSourceSelectArguments, DataSourceViewSelectCallback) Methode.

System_CAPS_pubpropertyStartRowIndex

Ruft ab oder legt einen Wert, der die Position darstellt, die das Datenquellen-Steuerelement beim Abrufen von Daten bei einem Vorgang zum Abrufen von Daten verwendet werden soll.

System_CAPS_pubpropertyTotalRowCount

Ruft ab oder legt die Anzahl der Zeilen, die bei einem Vorgang zum Abrufen von Daten abgerufen.

NameBeschreibung
System_CAPS_pubmethodAddSupportedCapabilities(DataSourceCapabilities)

Fügt eine Funktion, die DataSourceSelectArguments -Instanz, die zum Vergleichen verwendet wird, unterstützte und angeforderte Funktionen.

System_CAPS_pubmethodEquals(Object)

Bestimmt, ob das angegebene DataSourceSelectArguments Instanz ist gleich der aktuellen Instanz.(Überschreibt Object.Equals(Object).)

System_CAPS_pubmethodGetHashCode()

Gibt den Hashcode für die DataSourceSelectArguments Typ.(Überschreibt Object.GetHashCode().)

System_CAPS_pubmethodGetType()

Ruft den Type der aktuellen Instanz ab.(Geerbt von „Object“.)

System_CAPS_pubmethodRaiseUnsupportedCapabilitiesError(DataSourceView)

Vergleicht die Funktionen, die für angeforderte ein ExecuteSelect(DataSourceSelectArguments) Vorgang für diejenigen, die angegebene Datenquellensicht unterstützt.

System_CAPS_pubmethodToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.(Geerbt von „Object“.)

Verwenden von datengebundenen Steuerelementen die DataSourceSelectArguments Klasse, um anzufordern, dass ein Datenquellensteuerelement weitere datenbezogene Vorgänge für ein Resultset, z. B. Sortieren der Daten oder zum Zurückgeben einer bestimmten Teilmenge von Daten führt. Diese datenbezogenen Vorgänge werden von aufgelistet der DataSourceCapabilities Enumeration. In der folgenden Tabelle gibt an, wie die DataSourceSelectArguments Klasse unterstützt diese datenbezogene Vorgänge.

Funktion

Zugehörige DataSourceSelectArguments-Eigenschaften

DataSourceCapabilities.Sort

SortExpression

DataSourceCapabilities.Page

StartRowIndex, MaximumRows

DataSourceCapabilities.RetrieveTotalRowCount

RetrieveTotalRowCount, TotalRowCount

Datengebundene Steuerelemente explizit aufrufen der PerformSelect -Methode zum Binden von Daten, der aufgerufen wird, die Select(DataSourceSelectArguments, DataSourceViewSelectCallback) -Methode des Datenquellen-Steuerelements, die sie zugeordnet sind. Auf diese Weise Ruft das datengebundene Steuerelement Daten aus den Datenquellen-Steuerelement bei Bedarf ab. Da die Select(DataSourceSelectArguments, DataSourceViewSelectCallback) -Methode akzeptiert ein DataSourceSelectArguments Parameter, der das datengebundene Steuerelement ist verantwortlich für das Erstellen und Verwalten von ein DataSourceSelectArguments -Objekt und übergibt dieses an die Select(DataSourceSelectArguments, DataSourceViewSelectCallback) -Methode, wenn sie Daten aus den Datenquellen-Steuerelement abgerufen.

In einigen Fällen benötigen datengebundene Steuerelemente möglicherweise keine zusätzlichen datenbezogenen Funktionen. Übergeben Sie datengebundene Steuerelemente in diesem Fall eine Empty Arguments-Objekt an die Select(DataSourceSelectArguments, DataSourceViewSelectCallback) Methode.

Bei sortierten Resultsets überprüfen datengebundene Steuerelemente einer Datenquellensicht CanSort -Eigenschaft zur Laufzeit und fügen eine DataSourceCapabilities.Sort -Funktion die AddSupportedCapabilities(DataSourceCapabilities) Methode. Einem separaten Vorgang das datengebundene Steuerelement kann anfordern, ein sortiertes Resultset von einem Datenquellensteuerelement durch Festlegen der SortExpression Eigenschaft auf die DataSourceSelectArguments -Objekt übergeben, um die Select(DataSourceSelectArguments, DataSourceViewSelectCallback) Methode.

Einsatz von Paging überprüfen datengebundene Steuerelemente einer Datenquellensicht CanPage -Eigenschaft zur Laufzeit und fügen eine DataSourceCapabilities.Page -Funktion die AddSupportedCapabilities(DataSourceCapabilities) Methode. Einem separaten Vorgang das datengebundene Steuerelement kann anfordern, eine Teilmenge der Daten aus einem Datenquellen-Steuerelement für das Paging durch Festlegen der StartRowIndex und MaximumRows Eigenschaften für die DataSourceSelectArguments -Objekt übergeben, um die Select(DataSourceSelectArguments, DataSourceViewSelectCallback) Methode.

Zum Abrufen einer Gesamtzeilenanzahl von Paging überprüfen datengebundene Steuerelemente einer Datenquellensicht CanRetrieveTotalRowCount -Eigenschaft zur Laufzeit und fügen eine DataSourceCapabilities.RetrieveTotalRowCount -Funktion die AddSupportedCapabilities(DataSourceCapabilities) Methode. Einem separaten Vorgang das datengebundene Steuerelement kann Gesamtzeilenanzahl von anfordern ein Datenquellen-Steuerelement für das Paging durch Festlegen der RetrieveTotalRowCount Eigenschaft auf die DataSourceSelectArguments -Objekt übergeben, um die Select(DataSourceSelectArguments, DataSourceViewSelectCallback) Methode. Wenn die Select(DataSourceSelectArguments, DataSourceViewSelectCallback) Methode zurückgegeben wird, ist die Gesamtzeilenanzahl enthalten die TotalRowCount Eigenschaft.

System_CAPS_importantWichtig

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

.NET Framework
Verfügbar seit 2.0

Alle öffentlichen statischen Member ( Shared in Visual Basic) dieses Typs sind threadsicher. Die Threadsicherheit für Instanzmember ist nicht garantiert.

Zurück zum Anfang
Anzeigen: