Partager via

RecordCount, propriété (ADO)

  • Article

Indique le nombre d’enregistrements dans un objet Recordset.

Valeur renvoyée

Retourne une valeur Long qui indique le nombre d’enregistrements dans l’objet Recordset.

Notes

Utilisez la propriété RecordCount pour trouver le nombre d’enregistrements que contient un objet Recordset. La propriété retourne -1 si ADO ne peut pas déterminer le nombre d’enregistrements ou si le fournisseur ou le type de curseur ne prennent pas en charge la propriété RecordCount. La lecture de la propriété RecordCount sur un objet Recordset fermé provoque une erreur.

Signets ou positionnement approximatif

Si l’objet Recordset prend en charge les signets ou le positionnement approximatif, cette propriété retourne le nombre exact d’enregistrements dans l’objet Recordset. Cette propriété retourne le nombre exact, que l’objet Recordset ait été entièrement renseigné ou non.

En revanche, si l’objet Recordset ne prend pas en charge les signets ou le positionnement approximatif, l’accès à cette propriété peut entraîner une consommation importante de ressources. Celle-ci résulte du fait que, pour retourner une valeur RecordCount précise, tous les enregistrements doivent être récupérés et comptés.

  • adBookmark a trait au signets.
  • adApproxPosition a trait au positionnement approximatif.

Notes

Dans ADO versions 2.8 et antérieures, le fournisseur SQLOLEDB extrait tous les enregistrements lors de l’utilisation d’un curseur côté serveur, même s’il retourne la valeur True pour les deux options Supports (adApproxPosition) and Supports (adBookmark).

Le type de curseur de l’objet Recordset conditionne la possibilité de déterminer le nombre d’enregistrements. Selon la source de données, la propriété RecordCount retournera -1 pour un curseur avant uniquement, le nombre réel pour un curseur de jeu de clés statique, et -1 ou le nombre réel pour un curseur dynamique.

S'applique à

Recordset, objet (ADO)

Voir aussi

Filter et RecordCount, exemple de propriétés (VB)
Filter et RecordCount, exemple de propriétés (VC++)
AbsolutePosition, propriété (ADO)
PageCount, propriété (ADO)