ObjectDataSourceView.EnablePaging 屬性
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得或設定值,指出資料來源控制項是否支援對其擷取的資料集進行分頁。
public:
property bool EnablePaging { bool get(); void set(bool value); };
public bool EnablePaging { get; set; }
member this.EnablePaging : bool with get, set
Public Property EnablePaging As Boolean
屬性值
如果資料來源控制項支援對其擷取的資料進行分頁則為 true
,否則為 false
。
備註
控制項的 ObjectDataSourceView 分頁是藉由設定 EnablePaging 、 StartRowIndexParameterName 、 MaximumRowsParameterName 和 SelectCountMethod 屬性 ObjectDataSourceView 來處理,並使用適當的參數在商務物件中定義 Select
方法。 EnablePaging當 屬性設定為 true
時, SelectParameters 集合會包含所要求第一個資料列的兩個額外參數,以及所要求的資料列數目。 這兩個參數的名稱是由 和 MaximumRowsParameterName 屬性所 StartRowIndexParameterName 定義。 方法 Select
應該會傳回從指定索引開始的要求資料列數目。 因為資料可能不會平均除以頁面大小,所以最後一頁可能包含較少的資料列。 因此,要求的資料列數目實際上是傳回的資料列數目上限。
在 CanRetrieveTotalRowCount 呼叫 方法期間會檢查 屬性, ExecuteSelect 以確保資料來源控制項支援透過設定各種 DataSourceSelectArguments 屬性所要求的所有功能。
在相關聯的資料繫結控制項上啟用分頁時,資料繫結控制項會呼叫 Select
方法,其中包含開始索引和所需的資料列數目。 此外,如果 SelectCountMethod 已設定 屬性,資料繫結控制項會在轉譯呼叫器控制項之前呼叫 方法。 例如,如果 GridView 控制項已啟用頁面大小為 5 的分頁,而且 SelectCountMethod 方法會傳回 20,則只會在呼叫器中顯示 4 頁。
屬性的值 EnablePaging 會儲存在檢視狀態中。