RecordCount, propriété (ADO)

S’applique à : Access 2013, Office 2013

Indique le nombre d’enregistrements dans un objet Recordset.

Valeur renvoyée

Retourne une valeur de type Long qui indique le nombre d'enregistrements dans le Recordset.

Remarques

Utilisez la propriété RecordCount pour connaître le nombre d'enregistrements dans un objet Recordset. La propriété renvoie -1 quand ADO ne parvient pas à déterminer le nombre d'enregistrements ou si le fournisseur (ou le type de cursor) ne prend pas en charge la propriété RecordCount. Les tentatives de lecture de la propriété RecordCount sur un Recordset fermé génèrent une erreur.

Si l'objet Recordset prend en charge le positionnement approximatif ou les signets (c'est-à-dire si Supports (adApproxPosition) ou Supports (adBookmark), respectivement, renvoient la valeur True ) cette valeur est égale au nombre exact d'enregistrements dans le Recordset, qu'il soit complet ou non. Si l'objet Recordset ne prend pas en charge le positionnement approximatif, il se peut que cette propriété représente une charge significative pour les ressources, car tous les enregistrements devront être récupérés et comptés pour qu'une valeur RecordCount précise puisse être renvoyée.

Le type de curseur de l’objet Recordset détermine si le nombre d’enregistrements peut être déterminé. La propriété RecordCount renvoie -1 pour un curseur avant uniquement ; nombre réel d’un curseur statique ou d’un jeu de clés ; et -1 ou le nombre réel d’un curseur dynamique, selon la source de données.