Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Utilisez la propriété QueryExpression.PageInfo.ReturnTotalRecordCount booléenne pour spécifier que le résultat comprend un décompte de tous les enregistrements répondant aux critères de filtre, pouvant aller jusqu’à 5 000 pour les tables standard et 500 pour les tables élastiques. 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, la EntityCollection renvoyée par la méthode RetrieveMultiple comprend 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 valeur 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 est égal à la valeur maximale : 5 000 pour les tables standard et 500 pour les tables élastiques.
Si la taille de votre page est inférieure à la valeur maximale et 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 a la valeur true et 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 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.