DataSourceSelectArguments.RetrieveTotalRowCount Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft einen Wert ab, der angibt, ob ein Datenquellensteuerelement bei einem Datenabrufvorgang die Gesamtzeilenanzahl abrufen soll, oder legt diesen fest
public:
property bool RetrieveTotalRowCount { bool get(); void set(bool value); };
public bool RetrieveTotalRowCount { get; set; }
member this.RetrieveTotalRowCount : bool with get, set
Public Property RetrieveTotalRowCount As Boolean
Eigenschaftswert
true
, wenn das Datenquellensteuerelement die Gesamtdatenzeilenanzahl abrufen soll, andernfalls false
.
Hinweise
Die- RetrieveTotalRowCount Eigenschaft unterstützt Paging-Szenarios. Legen Sie diese Eigenschaft auf fest true
, um während des Datenabruf Vorgangs eine Gesamtanzahl von Zeilen aus dem Datenquellen-Steuerelement anzufordern. Überprüfen Sie die- DataSourceView.CanRetrieveTotalRowCount Eigenschaft, um zu bestimmen, ob eine Datenquellen Sicht das Abrufen der Gesamt Zeilen Anzahl unterstützt. Wenn die Datenquelle dies unterstützt, TotalRowCount wird die-Eigenschaft während eines Datenabruf Vorgangs vom Datenquellen-Steuerelement festgelegt, und die Gesamtanzahl der Daten Zeilen wird in der-Eigenschaft zurückgegeben TotalRowCount , ähnlich wie ein Wert in einem Output-Parameter einer-Methode zurückgegeben wird.
Wichtig
Wenn eine der DataSourceSelectArguments Eigenschaften festgelegt ist, das gegenwärtig gebundene Datenquellen-Steuerelement jedoch die angeforderte Funktion nicht unterstützt, InvalidOperationException wird beim Aufrufen der-Methode eine Ausnahme ausgelöst DataSourceSelectArguments.RaiseUnsupportedCapabilitiesError(DataSourceView) .