Zeilen mithilfe von FetchXml zählen

Verwenden Sie das boolesche Attribut Fetch-Elementreturntotalrecordcount, um anzugeben, dass das Ergebnis eine Anzahl aller Datensätze enthält, die 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 das Element abrufentop Attribut nicht zusammen mit returntotalrecordcount anwenden.

Das Verhalten, das Sie erwarten können, hängt davon ab, ob Sie das SDK für .NET oder die Web-API verwenden.

SDK für .NET

Wenn der Attributwert returntotalrecordcounttrue ist, enthält die von der RetrieveMultiple-Methode zurückgegebene EntityCollection Werte für die folgenden Eigenschaften:

Eigenschaften	Eigenschaft
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.

Web-API

Das Festlegen des Attributwerts returntotalrecordcount auf true hat das gleiche Ergebnis wie das Festlegen der OData-Abfrageoption $count. Sie können &$count=true an Ihre FetchXml-Abfrage anhängen, um die gleichen Ergebnisse zu erhalten. Erfahren Sie mehr über die OData-Abfrageoption $count.

Wenn Sie das returntotalrecordcount Attribut festlegen (oder die $count Abfrageoption verwenden), enthalten die zurückgegebenen Daten die @odata.count Anmerkung mit der Gesamtzahl der Datensätze, die den Filterkriterien entsprechen, bis zu 5.000 für Standardtabellen, 500 für elastische Tabellen.

Wenn Sie einen dieser Anforderungsheader einschließen:

Prefer: odata.include-annotations="Microsoft.Dynamics.CRM.totalrecordcount,Microsoft.Dynamics.CRM.totalrecordcountlimitexceeded"
   OR for all annotations:
Prefer: odata.include-annotations="*"

Die folgenden Anmerkungen werden zurückgegeben:

Eigenschaften	Eigenschaft
@Microsoft.Dynamics.CRM.totalrecordcount	Die Gesamtzahl der Datensätze beträgt bis zu 5.000; andernfalls ist der Wert -1. Der Wert ist derselbe wie die @odata.count-Anmerkung.
@Microsoft.Dynamics.CRM.totalrecordcountlimitexceeded	true, wenn die Ergebnisse der Abfrage die Gesamtzahl der Datensätze überschreitet, ansonsten false.

Der Wert (TotalRecordCountLimitExceeded oder @Microsoft.Dynamics.CRM.totalrecordcountlimitexceeded) ist nützlich, wenn Sie berechnen müssen, wie viele weitere ausgelagerte Anforderungen Sie senden müssen, um alle Ergebnisse zu erhalten, wenn (TotalRecordCount oder @Microsoft.Dynamics.CRM.totalrecordcount) der maximalen Seitengröße für den Tabellentyp entspricht, mit dem Sie arbeiten.

Wenn Ihre Seitengröße kleiner als das Maximum ist und (TotalRecordCount oder @Microsoft.Dynamics.CRM.totalrecordcount) gleich oder kleiner als das Maximum ist, können Sie berechnen, wie viele weitere ausgelagerte Anforderungen Sie senden müssen, um alle Datensätze zu erhalten.

Wenn (TotalRecordCountLimitExceeded oder @Microsoft.Dynamics.CRM.totalrecordcountlimitexceeded) true ist und (TotalRecordCount oder @Microsoft.Dynamics.CRM.totalrecordcount) gleich dem Maximum ist, können Sie diese Berechnung nicht durchführen.

Trinkgeld

Wenn Sie eine Gesamtanzahl der Datensätze ohne Filter erhalten möchten, verwenden Sie die RetrieveTotalRecordCount-Nachricht entweder mit der RetrieveTotalRecordCount-Funktion der Web-API oder mit der RetrieveTotalRecordCountRequest-Klasse von SDK für .NET. Die abgerufenen Daten stammen aus einer Momentaufnahme der letzten 24 Stunden.

Nächste Schritte,

Erfahren Sie, wie Sie die Leistung optimieren.

Optimieren der Leistung