DataSourceSelectArguments.RetrieveTotalRowCount 屬性
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得或設定值,指出資料擷取作業時資料來源控制項是否應該擷取所有資料列的計數。
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
屬性值
如果資料來源控制項應該擷取資料列總數,則為 true
,否則為 false
。
備註
RetrieveTotalRowCount屬性支援分頁案例。 將這個屬性設定為,以在資料抓取作業 true
期間,從資料來源控制項要求總計資料列計數。 檢查 DataSourceView.CanRetrieveTotalRowCount 屬性,以判斷資料來源視圖是否支援抓取總數據列計數。 如果資料來源支援它,則在 TotalRowCount 資料抓取作業期間,資料來源控制項會設定此屬性,而且會在屬性中傳回總數據列計數 TotalRowCount ,因為在方法的 output 參數中傳回值。
重要
如果 DataSourceSelectArguments 已設定任何屬性,但目前系結的資料來源控制項不支援所要求的功能,則會 InvalidOperationException 在呼叫方法時擲 DataSourceSelectArguments.RaiseUnsupportedCapabilitiesError(DataSourceView) 回例外狀況。