DataSourceSelectArguments.MaximumRows 屬性

定義

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

取得或設定值，表示資料來源控制項為資料擷取作業傳回的資料列最大數目。

public:
 property int MaximumRows { int get(); void set(int value); };

public int MaximumRows { get; set; }

member this.MaximumRows : int with get, set

Public Property MaximumRows As Integer

資料來源為資料擷取資作業傳回的資料列最大數目。預設值為 0，表示傳回所有可能的資料列。

MaximumRows屬性支援分頁案例。資料繫結控制項會在執行時間檢查資料來源 view 的 CanPage 屬性，並在 DataSourceCapabilities.Page AddSupportedCapabilities(DataSourceCapabilities) 視圖支援分頁時使用方法來加入功能。如果資料繫結控制項無法加入功能，而且在資料抓取作業 DataSourceSelectArguments 期間傳遞至資料來源視圖的物件上設定了分頁屬性，則可能會擲回例外狀況 InvalidOperationException 。

資料繫結控制項可以藉由在 StartRowIndex MaximumRows 傳遞至方法的物件上設定和屬性，從資料來源控制項要求資料的子集進行分頁 DataSourceSelectArguments Select(DataSourceSelectArguments, DataSourceViewSelectCallback) 。

重要

如果 DataSourceSelectArguments 已設定任何屬性，但目前系結的資料來源控制項不支援所要求的功能，則會 InvalidOperationException 在呼叫方法時擲 DataSourceSelectArguments.RaiseUnsupportedCapabilitiesError(DataSourceView) 回例外狀況。