ObjectDataSourceView.EnablePaging 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 das Datenquellen-Steuerelement Paging für den von ihm abgerufenen Datensatz unterstützt, oder legt diesen fest.
public:
property bool EnablePaging { bool get(); void set(bool value); };public bool EnablePaging { get; set; }member this.EnablePaging : bool with get, setPublic Property EnablePaging As BooleanEigenschaftswert
true, wenn das Datenquellen-Steuerelement Paging für die von ihm abgerufenen Daten unterstützt, andernfalls false.
Hinweise
Das Paging durch das ObjectDataSourceView Steuerelement wird behandelt, indem die EnablePagingStartRowIndexParameterNameMaximumRowsParameterNameEigenschaften und SelectCountMethod Eigenschaften der ObjectDataSourceView methode im Geschäftsobjekt mit den richtigen Parametern festgelegt Select werden. Wenn die Eigenschaft auf true"Festgelegt" festgelegt ist, enthält die EnablePaging SelectParameters Auflistung zwei zusätzliche Parameter für die angeforderte erste Zeile und die Anzahl der angeforderten Zeilen. Diese beiden Parameter werden gemäß der Definition und den StartRowIndexParameterName MaximumRowsParameterName Eigenschaften benannt. Die Select Methode sollte die angeforderte Anzahl von Zeilen zurückgeben, die am angegebenen Index beginnen. Da die Daten möglicherweise nicht gleichmäßig durch die Seitengröße dividiert werden, enthält die letzte Seite möglicherweise weniger Zeilen. Daher ist die Anzahl der angeforderten Zeilen tatsächlich die maximale Anzahl von Zeilen, die zurückgegeben werden.
Die CanRetrieveTotalRowCount Eigenschaft wird während eines Aufrufs der ExecuteSelect Methode überprüft, um sicherzustellen, dass das Datenquellensteuerelement alle funktionen unterstützt, die durch Festlegen der verschiedenen DataSourceSelectArguments Eigenschaften angefordert werden.
Wenn das Paging für das zugeordnete datengebundene Steuerelement aktiviert ist, ruft das datengebundene Steuerelement die Select Methode mit dem Startindex und der Anzahl der zeilen auf, die erforderlich sind. Wenn die SelectCountMethod Eigenschaft festgelegt wird, ruft das datengebundene Steuerelement die Methode auf, bevor die Pagersteuerelemente gerendert werden. Wenn z. B. ein GridView Steuerelement mit einer Seitengröße von 5 aktiviert ist und die SelectCountMethod Methode 20 zurückgibt, werden nur 4 Seiten im Pager angezeigt.
Der Wert der EnablePaging Eigenschaft wird im Ansichtszustand gespeichert.