Décompte des lignes

S’applique à : Access 2013, Office 2013

La propriété RecordCount renvoie une valeur de type Long qui indique le nombre d'enregistrements de l'objet Recordset. Utilisez la propriété RecordCount pour déterminer le nombre d'enregistrements d'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. Toute tentative de lecture de la propriété RecordCount sur un objet Recordset fermé génère une erreur.

La propriété RecordCount dépend des fonctionnalités du fournisseur et du type de curseur. La propriété RecordCount retourne -1 pour un curseur avant uniquement, le nombre réel pour un curseur statique ou de type jeu de clés et enfin, soit -1, soit le nombre réel pour un curseur dynamique, selon la source de données.

L’exemple d’objet Recordset présenté dans la section Examen des données retourne –1 dans la mesure où un curseur avant uniquement a été ouvert. Pour pouvoir utiliser la propriété RecordCount, vous devez ouvrir l'objet Recordset avec un curseur plus élaboré (statique ou jeu de clés).

Dans certains cas, le fournisseur ou le curseur ne peut fournir la valeur RecordCount qu'en procédant au préalable à une extraction de tous les enregistrements à partir de la source de données. Pour forcer ce type d’extraction, appelez la méthode RecordsetMoveLast avant d’appeler RecordCount.

Si vous deviez remplacer la ligne de code qui appelle la méthode RecordsetOpen par ce qui suit :

 
oRs.Open sSQL, sCnStr, adOpenStatic, adLockOptimistic, adCmdText 

vous pouvez utiliser la propriété RecordCount dans la mesure où les curseurs statiques et le fournisseur Microsoft OLE DB pour SQL Server prennent en charge la propriété RecordCount. À titre d'exemple, le code suivant imprime le nombre d'enregistrements retourné par la commande dans la fenêtre de débogage, en supposant que le curseur prend en charge la propriété RecordCount:

 
Debug.Print oRs.RecordCount ' Output: 4 

À ce stade, il est supposé que des paramètres de curseurs et verrous de ce type sont utilisés. En effet, ils offrent davantage de fonctionnalités même s'ils sont plus coûteux.