Freigeben über


DataSourceSelectArguments.RetrieveTotalRowCount Eigenschaft

Definition

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

Boolean

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) .

Gilt für

Siehe auch