Compter les lignes à l’aide de QueryExpression
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.
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é).