Zeilen mithilfe von FetchXml zählen

Verwenden Sie das boolesche Attribut Fetch-Element returntotalrecordcount, 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 Attribut Fetch-Element top 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 returntotalrecordcount true ist, enthält die von der RetrieveMultiple-Methode zurückgegebene EntityCollection 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.

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) umfassen die zurückgegebenen Daten die @odata.count-Anmerkung mit der Gesamtzahl der Datensätze, die den Filterkriterien entsprechen, und zwar bis zu 5.000.

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 Anfragen Sie senden müssen, um alle Ergebnisse zu erhalten, wenn (TotalRecordCount oder @Microsoft.Dynamics.CRM.totalrecordcount) 5.000 entspricht.

Wenn Ihre Seitengröße kleiner als das Maximum ist und (TotalRecordCount oder @Microsoft.Dynamics.CRM.totalrecordcount) gleich oder kleiner als 5.000 ist, können Sie berechnen, wie viele weitere ausgelagerte Anfragen 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 5.000 ist, können Sie diese Berechnung nicht durchführen.

Tipp

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

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).