Recordset.RecordCount, propriété (DAO)

S’applique à : Access 2013, Office 2013

Renvoie le nombre d’enregistrements accessibles dans un objet Recordset ou le nombre total d’enregistrements dans un objet Recordset de type table. ou Objet TableDef . Long (en lecture seule).

Syntaxe

expression .RecordCount

expression Variable représentant un objet Recordset.

Remarques

Utilisez le RecordCount propriété pour déterminer le nombre d’enregistrements dans une jeu d’enregistrements ou TableDef objet aient été accédé. Le RecordCount propriété n’indique pas combien enregistrements sont contenus dans un type vers l’avant uniquement, instantané – ou feuille de réponse dynamique jeu d’enregistrements objet jusqu'à ce que tous les enregistrements ont été consultés. Une fois le dernier enregistrement a été accédé, le RecordCount propriété indique le nombre total d’enregistrements non supprimés dans la jeu d’enregistrements ou TableDef objet. Pour forcer le dernier enregistrement pour pouvoir y accéder, utilisez la MoveLast méthode sur le jeu d’enregistrements objet. Vous pouvez également utiliser une SQL Count fonction pour déterminer le nombre d’enregistrements votre requête renverra approximatif.

Remarque

[!REMARQUE] L'utilisation de la méthode MoveLast pour remplir un objet Recordset récemment ouvert affecte les performances. Sauf s'il est indispensable de connaître précisément la valeur de la propriété RecordCount dès l'ouverture d'un objet Recordset, il est préférable d'attendre que l'objet Recordset soit rempli avec d'autres sections de code avant de vérifier la valeur de la propriété RecordCount.

À mesure que votre application supprime des enregistrements dans un objet Recordset de type feuille de réponse dynamique, la valeur de la propriété RecordCount diminue. Toutefois, les enregistrements supprimés par d'autres utilisateurs ne sont pas répercutés dans la propriété RecordCount tant que l'enregistrement actif est positionné sur un enregistrement supprimé. Si vous exécutez une transaction qui a une influence sur le paramètre de propriété RecordCount et que vous restaurez par la suite la transaction, la propriété RecordCount ne reflètera pas le nombre réel d’enregistrements restants.

La propriété RecordCount d’un objet Recordset de type capture instantanée ou transfert uniquement n’est pas concernée par les modifications apportées aux tables sous-jacentes.

A jeu d’enregistrements ou TableDef de l’objet sans enregistrement contient un RecordCount paramètre de la propriété de 0.

À l’aide de la interroger à nouveau méthode sur un jeu d’enregistrements objet réinitialisation le RecordCount propriété simplement comme si la requête nouveau exécutée.

Exemple

Cet exemple illustre la RecordCount propriété avec différents types de jeux d’enregistrements qui précèdent et suivent qu’ils sont remplis.

    Sub RecordCountX() 
     
     Dim dbsNorthwind As Database 
     Dim rstEmployees As Recordset 
     
     Set dbsNorthwind = OpenDatabase("Northwind.mdb") 
     
     With dbsNorthwind 
     ' Open table-type Recordset and show RecordCount 
     ' property. 
     Set rstEmployees = .OpenRecordset("Employees") 
     Debug.Print _ 
     "Table-type recordset from Employees table" 
     Debug.Print " RecordCount = " & _ 
     rstEmployees.RecordCount 
     rstEmployees.Close 
     
     ' Open dynaset-type Recordset and show RecordCount 
     ' property before populating the Recordset. 
     Set rstEmployees = .OpenRecordset("Employees", _ 
     dbOpenDynaset) 
     Debug.Print "Dynaset-type recordset " & _ 
     "from Employees table before MoveLast" 
     Debug.Print " RecordCount = " & _ 
     rstEmployees.RecordCount 
     
     ' Show the RecordCount property after populating the 
     ' Recordset. 
     rstEmployees.MoveLast 
     Debug.Print "Dynaset-type recordset " & _ 
     "from Employees table after MoveLast" 
     Debug.Print " RecordCount = " & _ 
     rstEmployees.RecordCount 
     rstEmployees.Close 
     
     ' Open snapshot-type Recordset and show RecordCount 
     ' property before populating the Recordset. 
     Set rstEmployees = .OpenRecordset("Employees", _ 
     dbOpenSnapshot) 
     Debug.Print "Snapshot-type recordset " & _ 
     "from Employees table before MoveLast" 
     Debug.Print " RecordCount = " & _ 
     rstEmployees.RecordCount 
     
     ' Show the RecordCount property after populating the 
     ' Recordset. 
     rstEmployees.MoveLast 
     Debug.Print "Snapshot-type recordset " & _ 
     "from Employees table after MoveLast" 
     Debug.Print " RecordCount = " & _ 
     rstEmployees.RecordCount 
     rstEmployees.Close 
     
     ' Open forward-only-type Recordset and show 
     ' RecordCount property before populating the 
     ' Recordset. 
     Set rstEmployees = .OpenRecordset("Employees", _ 
     dbOpenForwardOnly) 
     Debug.Print "Forward-only-type recordset " & _ 
     "from Employees table before MoveLast" 
     Debug.Print " RecordCount = " & _ 
     rstEmployees.RecordCount 
     
     ' Show the RecordCount property after calling the 
     ' MoveNext method. 
     rstEmployees.MoveNext 
     Debug.Print "Forward-only-type recordset " & _ 
     "from Employees table after MoveNext" 
     Debug.Print " RecordCount = " & _ 
     rstEmployees.RecordCount 
     rstEmployees.Close 
     
     .Close 
     End With 
     
    End Sub