ブール値 QueryExpression.PageInfo.ReturnTotalRecordCount プロパティを使用して、フィルタ条件を満たすすべてのレコードのカウントを結果に含めるように指定します (標準テーブルの場合は最大 5,000、エラスティック テーブルの場合は最大 500)。 ページ化された結果を取得するときにこれを使用して、表示する合計ページ数を推定します。
QueryExpression.TopCount プロパティ を ReturnTotalRecordCount と一緒に使用できません。
例
ReturnTotalRecordCount プロパティの値が true の場合、RetrieveMultiple メソッドから返される EntityCollection には、以下のプロパティの値が含まれます:
| Property | プロパティ |
|---|---|
| TotalRecordCount | レコードの合計数は最大 5000、それ以外の場合、値は -1です。 |
| TotalRecordCountLimitExceeded | クエリの結果が総レコード数を超えていれば true、そうでなければ false です。 |
TotalRecordCountLimitExceeded の値は、TotalRecordCount が最大値 (標準テーブルの場合は 5,000、エラスティック テーブルの場合は 500) になったときに、すべての結果を取得するために送信する必要のあるページ リクエストの数を計算する場合に役立ちます。
ページ サイズが最大値より小さく、TotalRecordCount が最大値以下である場合、すべてのレコードを取得するためにあと何回ページング リクエストを送信する必要があるかを計算できます。
TotalRecordCountLimitExceeded が true で、TotalRecordCount が最大値に等しい場合、この計算はできません。
チップ
フィルターなしでレコードの合計数を取得する場合は、RetrieveTotalRecordCountRequest クラス を使用します。 取得されるデータは、過去 24 時間以内のスナップ ショットからのものになります。
次の手順
フォームのパフォーマンスを最適化する方法について解説します。