Compter des lignes à l’aide de FetchXml

Utilisez l’attribut de l’returntotalrecordcount pour spécifier que le résultat inclut un décompte de tous les enregistrements qui répondent aux critères de filtre, pouvant aller jusqu’à 5 000. Utilisez cet attribut lors de la récupération des résultats paginés pour estimer le nombre total de pages à afficher.

Vous ne pouvez pas appliquer l’attribut de l’top avec returntotalrecordcount.

Le comportement que vous pouvez attendre dépend si vous utilisez le SDK pour .NET ou l’API Web.

SDK pour .NET
API web

Lorsque la valeur de l’attribut returntotalrecordcount est true, la EntityCollection renvoyée par la méthode RetrieveMultiple inclut des valeurs pour les propriétés suivantes :

Property	Description
TotalRecordCount	Le nombre total d’enregistrements pouvant aller jusqu’à 5 000 ; sinon, la valeur est -1.
TotalRecordCountLimitExceeded	`true` si les résultats de la requête dépassent le nombre total d’enregistrements ; sinon, `false`.

La définition de la valeur de l’attribut returntotalrecordcount sur true a le même résultat que la définition de l’option de requête $count d’OData. Vous pouvez ajouter &$count=true à votre requête FetchXml pour obtenir les mêmes résultats. En savoir plus sur l’option de requête $count d’OData.

Lorsque vous définissez l’attribut returntotalrecordcount (ou utilisez l’option de requête $count), les données renvoyées comprennent l’annotation @odata.count avec le nombre total d’enregistrements correspondant aux critères de filtre, pouvant aller jusqu’à 5 000 pour les tables standard et 500 pour les tables élastiques.

Si vous incluez l’un de ces en-têtes de demande :

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

Les annotations suivantes seront renvoyées :

Property	Description
`@Microsoft.Dynamics.CRM.totalrecordcount`	Le nombre total d’enregistrements pouvant aller jusqu’à 5 000 ; sinon, la valeur est -1. La valeur est la même que celle de l’annotation `@odata.count`.
`@Microsoft.Dynamics.CRM.totalrecordcountlimitexceeded`	`true` si les résultats de la requête dépassent le nombre total d’enregistrements ; sinon, `false`.

La valeur (TotalRecordCountLimitExceeded ou @Microsoft.Dynamics.CRM.totalrecordcountlimitexceeded) est utile lorsque vous devez calculer le nombre de demandes paginées supplémentaires que vous devez envoyer pour obtenir tous les résultats lorsque (TotalRecordCount ou @Microsoft.Dynamics.CRM.totalrecordcount) est égal à la taille de page maximale pour le type de table que vous utilisez.

Si la taille de votre page est inférieure à la valeur maximale et (TotalRecordCount ou @Microsoft.Dynamics.CRM.totalrecordcount) est égal ou inférieur à la valeur maximale, vous pouvez calculer le nombre de demandes paginées supplémentaires que vous devez envoyer pour obtenir tous les enregistrements.

Lorsque (TotalRecordCountLimitExceeded ou @Microsoft.Dynamics.CRM.totalrecordcountlimitexceeded) a la valeur true et (TotalRecordCount ou @Microsoft.Dynamics.CRM.totalrecordcount) est égal à la valeur maximale, vous ne pouvez pas effectuer ce calcul.

Astuce

Si vous souhaitez obtenir un nombre total d’enregistrements sans filtre, utilisez le message RetrieveTotalRecordCount avec soit la fonction RetrieveTotalRecordCount de l’API web, soit avec la classe RetrieveTotalRecordCountRequest du SDK pour .NET. Les données récupérées proviendront d’un instantané au cours des dernières 24 heures.

Étapes suivantes

Découvrez comment optimiser les performances.

Optimiser les performances

Commentaires

Cette page a-t-elle été utile ?

Last updated on 2025-06-10

Partager via

Compter des lignes à l’aide de FetchXml

Étapes suivantes

Commentaires

Ressources supplémentaires