QueryExpression を使用して行を数える
ブール値 QueryExpression.PageInfo.ReturnTotalRecordCount プロパティ を使用して、結果にフィルター条件を満たすすべてのレコードの数 (最大 5000 件) が含まれるように指定します。 ページ化された結果を取得するときにこれを使用して、表示する合計ページ数を推定します。
QueryExpression.TopCount プロパティ を ReturnTotalRecordCount と一緒に使用できません。
例
ReturnTotalRecordCount プロパティ の値が trueの場合、EntityCollection RetrieveMultipleから返されたメソッドには、次のプロパティの値が含まれます。
| プロパティ | 説明 |
|---|---|
| TotalRecordCount | レコードの合計数は最大 5000、それ以外の場合、値は -1です。 |
| TotalRecordCountLimitExceeded | クエリの結果が総レコード数を超えていれば true、そうでなければ false です。 |
TotalRecordCountLimitExceeded の値は、値が TotalRecordCount 5000 の場合に、すべての結果を取得するために送信する必要があるページングされた要求の数を計算する必要があるときに役立ちます。
ページ サイズが最大値より小さく、TotalRecordCount 5000 以下の場合は、すべてのレコードを取得するために送信する必要があるページ要求の数を計算できます。
TotalRecordCountLimitExceeded が true かつ TotalRecordCount 5000 に等しい場合、この計算は実行できません。
ヒント
フィルターなしでレコードの合計数を取得する場合は、RetrieveTotalRecordCountRequest クラス を使用します。 取得されるデータは、過去 24 時間以内のスナップ ショットからのものになります。
次の手順
フォームのパフォーマンスを最適化する方法について解説します。
注意
ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)
この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。