Partager via


Compter des lignes à l’aide de FetchXml

Utilisez l’attribut returntotalrecordcount de l’élément fetch 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 top de l’élément fetch avec returntotalrecordcount.

Le comportement que vous pouvez attendre dépend si vous utilisez le SDK pour .NET ou l’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 :

Propriété 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 valeur (TotalRecordCountLimitExceeded ou @Microsoft.Dynamics.CRM.totalrecordcountlimitexceeded) est utile lorsque vous devez calculer le nombre de requêtes paginées supplémentaires que vous devez envoyer pour obtenir tous les résultats lorsque (TotalRecordCount ou @Microsoft.Dynamics.CRM.totalrecordcount) est égal à 5 000.

Si la taille de votre page est inférieure à la valeur maximale et que (TotalRecordCount ou @Microsoft.Dynamics.CRM.totalrecordcount) est inférieur ou égal à 5 000, vous pouvez calculer le nombre de requêtes 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 à 5 000, vous ne pouvez pas effectuer ce calcul.

Conseil

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.

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).