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 メソッドの出力パラメーターで値が返されるため、プロパティには合計データ行数が返されます。
重要
いずれかの DataSourceSelectArguments プロパティが設定されていても、現在バインドされているデータソースコントロールが要求された機能をサポートしていない場合、 InvalidOperationException メソッドが呼び出されると例外がスローされ DataSourceSelectArguments.RaiseUnsupportedCapabilitiesError(DataSourceView) ます。