Partage via

Compter les lignes à l’aide de QueryExpression

  • Article

Utilisez la propriété booléen QueryExpression.PageInfo.ReturnTotalRecordCount pour spécifier que le résultat inclut un nombre de tous les enregistrements qui répondent aux critères de filtre, 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.

N’utilisez pas la propriété QueryExpression.TopCount avec ReturnTotalRecordCount.

Exemple

Lorsque la valeur de la propriété ReturnTotalRecordCount est true, le EntityCollection renvoyé par le RetrieveMultiple la méthode 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 TotalRecordCountLimitExceeded valeur 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 est égal à 5 000.

Si la taille de votre page est inférieure au maximum et TotalRecordCount est égale ou inférieure à 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 est true et 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 la classe RetrieveTotalRecordCountRequest. 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

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