FetchXml を使用して行をカウントする
fetch 要素 の ブール値 returntotalrecordcount
属性を使用して、フィルター条件を満たすすべてのレコード (最大 5000件) のカウントを結果に含めるように指定します。 ページ化された結果を取得するときにこれを使用して、表示する合計ページ数を推定します。
returntotalrecordcount
と一緒に fetch 要素 の top
属性を適用することはできません。
期待できる動作は、SDK for .NET または Web API のどちらを使用しているかによって異なります。
returntotalrecordcount
属性値が true
の場合、RetrieveMultiple メソッドから返される EntityCollection には以下のプロパティの値が含まれます:
プロパティ | 説明 |
---|---|
TotalRecordCount | レコードの合計数は最大 5000、それ以外の場合、値は -1です。 |
TotalRecordCountLimitExceeded | クエリの結果が総レコード数を超えていれば true 、そうでなければ false です。 |
(TotalRecordCountLimitExceeded or @Microsoft.Dynamics.CRM.totalrecordcountlimitexceeded
) 値は、(TotalRecordCount または @Microsoft.Dynamics.CRM.totalrecordcount
) は 5000 に相当します。
ページ サイズが最大値より小さく、(TotalRecordCount または @Microsoft.Dynamics.CRM.totalrecordcount
)が 5000 以下である場合、すべてのレコードを取得するためにあと何回ページング リクエストを送信する必要があるかを計算することができます。
(TotalRecordCountLimitExceeded または @Microsoft.Dynamics.CRM.totalrecordcountlimitexceeded
) が true
で、(TotalRecordCount または @Microsoft.Dynamics.CRM.totalrecordcount
) が 5000 に等しい場合、この計算はできません。
ヒント
フィルターを使わずにレコードの総数を取得するには、Web API RetrieveTotalRecordCount function または SDK for .NET RetrieveTotalRecordCountRequest class を用いて RetrieveTotalRecordCount
メッセージを使用します。 取得されるデータは、過去 24 時間以内のスナップ ショットからのものになります。
次の手順
フォームのパフォーマンスを最適化する方法について解説します。
注意
ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)
この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。