(0) exportieren Drucken
Alle erweitern
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

DataSourceSelectArguments-Klasse

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

System.Object
  System.Web.UI.DataSourceSelectArguments

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

public sealed class DataSourceSelectArguments

Der DataSourceSelectArguments-Typ macht die folgenden Member verfügbar.

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

  NameBeschreibung
Öffentliche EigenschaftStatischer MemberEmptyRuft ein DataSourceSelectArguments-Objekt ab, dessen Sortierausdruck auf Empty festgelegt ist.
Öffentliche EigenschaftMaximumRowsRuft einen Wert ab, der die maximale Anzahl von Datenzeilen darstellt, die ein Datenquellensteuerelement bei einem Datenabrufvorgang zurückgibt, oder legt diesen fest.
Öffentliche EigenschaftRetrieveTotalRowCountRuft einen Wert ab, der angibt, ob ein Datenquellensteuerelement bei einem Datenabrufvorgang die Gesamtzeilenanzahl abrufen soll, oder legt diesen fest.
Öffentliche EigenschaftSortExpressionRuft einen Ausdruck ab, mit dem die Datenquellenansicht die von der DataSourceView.Select(DataSourceSelectArguments, DataSourceViewSelectCallback)-Methode abgerufenen Daten sortiert, oder legt diesen fest.
Öffentliche EigenschaftStartRowIndexRuft einen Wert ab, der die Startposition darstellt, die das Datenquellensteuerelement bei einem Datenabrufvorgang zum Abrufen der Datenzeilen verwenden soll, oder legt diesen fest.
Öffentliche EigenschaftTotalRowCountRuft die Anzahl von Zeilen ab, die bei einem Datenabrufvorgang abgerufen wird, oder legt diese fest.
Zum Seitenanfang

  NameBeschreibung
Öffentliche MethodeAddSupportedCapabilitiesFügt der DataSourceSelectArguments-Instanz eine Funktion hinzu, anhand derer unterstützte und angeforderte Funktionen verglichen werden.
Öffentliche MethodeEqualsBestimmt, ob die angegebene DataSourceSelectArguments-Instanz gleich der aktuellen Instanz ist. (Überschreibt Object.Equals(Object).)
Öffentliche MethodeGetHashCodeGibt den Hashcode für den DataSourceSelectArguments-Typ zurück. (Überschreibt Object.GetHashCode().)
Öffentliche MethodeGetTypeRuft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Öffentliche MethodeRaiseUnsupportedCapabilitiesErrorVergleicht die für einen ExecuteSelect(DataSourceSelectArguments)-Vorgang angeforderten Funktionen mit denen, die von einer bestimmten Datenquellenansicht unterstützt werden.
Öffentliche MethodeToStringGibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)
Zum Seitenanfang

Mithilfe der DataSourceSelectArguments-Klasse fordern datengebundene Steuerelemente an, dass ein Datenquellensteuerelement weitere datenbezogene Vorgänge für ein Resultset durchführt, beispielsweise das Sortieren der Daten oder das Zurückgeben einer bestimmten Datenteilmenge. Diese datenbezogenen Vorgänge werden von der DataSourceCapabilities-Enumeration aufgelistet. Die folgende Tabelle gibt an, wie die DataSourceSelectArguments-Klasse diese datenbezogenen Vorgänge unterstützt.

Steuerelemente rufen zum Binden von Daten explizit die PerformSelect-Methode auf, die die Select(DataSourceSelectArguments, DataSourceViewSelectCallback)-Methode des Datenquellensteuerelements aufruft, dem sie zugeordnet ist. Auf diese Art rufen datengebundene Steuerelemente bei Bedarf Daten vom Datenquellensteuerelement ab. Da die Select(DataSourceSelectArguments, DataSourceViewSelectCallback)-Methode einen DataSourceSelectArguments-Parameter akzeptiert, erstellt und verwaltet das datengebundene Steuerelement beim Abrufen von Daten vom Datenquellensteuerelement ein DataSourceSelectArguments-Objekt und übergibt dieses an die Select(DataSourceSelectArguments, DataSourceViewSelectCallback)-Methode.

In einigen Fällen benötigen datengebundene Steuerelemente keine zusätzlichen datenbezogenen Funktionen. Sie übergeben dann 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 mithilfe der AddSupportedCapabilities(DataSourceCapabilities)-Methode eine DataSourceCapabilities.Sort-Funktion hinzu. Datengebundene Steuerelemente können in einem separaten Vorgang ein sortiertes Resultset von einem Datenquellensteuerelement anfordern, indem sie die SortExpression-Eigenschaft des DataSourceSelectArguments-Objekts festlegen, das an die Select(DataSourceSelectArguments, DataSourceViewSelectCallback)-Methode übergeben wird.

Beim Einsatz von Paging überprüfen datengebundene Steuerelemente die CanPage-Eigenschaft einer Datenquellenansicht zur Laufzeit und fügen mithilfe der AddSupportedCapabilities(DataSourceCapabilities)-Methode eine DataSourceCapabilities.Page-Funktion hinzu. Datengebundene Steuerelemente können in einem separaten Vorgang von einem Datenquellensteuerelement eine Datenteilmenge für das Paging anfordern, indem sie die StartRowIndex-Eigenschaft und die MaximumRows-Eigenschaft des DataSourceSelectArguments-Objekts festlegen, das an die Select(DataSourceSelectArguments, DataSourceViewSelectCallback)-Methode übergeben wird.

Zum Abrufen der Gesamtzeilenanzahl in Pagingszenarios überprüfen datengebundene Steuerelemente die CanRetrieveTotalRowCount-Eigenschaft einer Datenquellenansicht zur Laufzeit und fügen mithilfe der AddSupportedCapabilities(DataSourceCapabilities)-Methode eine DataSourceCapabilities.RetrieveTotalRowCount-Funktion hinzu. Datengebundene Steuerelemente können in einem separaten Vorgang von einem Datenquellensteuerelement die Gesamtzeilenanzahl für das Paging anfordern, indem sie die RetrieveTotalRowCount-Eigenschaft des DataSourceSelectArguments-Objekts festlegen, das an die Select(DataSourceSelectArguments, DataSourceViewSelectCallback)-Methode übergeben wird. Wenn die Select(DataSourceSelectArguments, DataSourceViewSelectCallback)-Methode zurückgegeben wird, wird die Gesamtzeilenanzahl von der TotalRowCount-Eigenschaft unterdrückt.

Wichtiger HinweisWichtig

Wenn eine der DataSourceSelectArguments-Eigenschaften festgelegt ist, das gegenwärtig gebundene Datenquellensteuerelement die angeforderte Funktion jedoch nicht unterstützt, wird beim Aufrufen der DataSourceSelectArguments.RaiseUnsupportedCapabilitiesError(DataSourceView)-Methode eine InvalidOperationException-Ausnahme ausgelöst.

.NET Framework

Unterstützt in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft