Zeilen mithilfe von QueryExpression zählen
Verwenden Sie die boolesche QueryExpression.PageInfo.ReturnTotalRecordCount-Eigenschaft, um anzugeben, dass das Ergebnis die Anzahl aller Datensätze enthalten soll, welche die Filterkriterien erfüllen (bis zu 5.000). Verwenden Sie dies beim Abrufen von Seitenergebnissen, um die Gesamtzahl der anzuzeigenden Seiten abzuschätzen.
Sie können die QueryExpression.TopCount-Eigenschaft nicht zusammen mit ReturnTotalRecordCount verwenden.
Beispiel
Wenn der Wert der ReturnTotalRecordCount-Eigenschaft true ist, enthält die EntityCollection, die von der Methode RetrieveMultiple zurückgegeben wird, Werte für die folgenden Eigenschaften:
| Eigenschaften | Beschreibung |
|---|---|
| TotalRecordCount | Die Gesamtzahl der Datensätze beträgt bis zu 5.000; andernfalls ist der Wert -1. |
| TotalRecordCountLimitExceeded | true, wenn die Ergebnisse der Abfrage die Gesamtzahl der Datensätze überschreitet, ansonsten false. |
Der TotalRecordCountLimitExceeded-Wert ist hilfreich, wenn Sie berechnen müssen, wie viele weitere seitenweise Anforderungen Sie senden müssen, um alle Ergebnisse zu erhalten, wenn TotalRecordCount gleich 5.000 ist.
Wenn Ihre Seitengröße unter dem Maximum liegt und TotalRecordCount gleich oder kleiner als 5.000 ist, können Sie berechnen, wie viele weitere seitenweise Anforderungen Sie senden müssen, um alle Datensätze abzurufen.
Wenn TotalRecordCountLimitExceeded auf true steht und TotalRecordCount gleich 5.000 ist, können Sie diese Berechnung nicht durchführen.
Tipp
Wenn Sie eine Gesamtzahl der Datensätze ohne Filter erhalten möchten, verwenden Sie die RetrieveTotalRecordCountRequest-Klasse. Die abgerufenen Daten stammen aus einer Momentaufnahme der letzten 24 Stunden.
Nächste Schritte,
Erfahren Sie, wie Sie die Leistung optimieren.
Hinweis
Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)
Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).