Accès à un enregistrement

S’applique à : Access 2013, Office 2013

La méthode Move vous permet d'avancer ou de reculer d'un nombre spécifié d'enregistrements dans l'objet Recordset, en utilisant la syntaxe suivante :

 
oRs.Move NumRecords, Start

La méthode Move est prise en charge sur tous les objets Recordset.

Si l'argument NumRecords est supérieur à zéro, la position de l'enregistrement actif est avancée (vers la fin du jeu d'enregistrements). Si l'argument NumRecords est inférieur à zéro, la position de l'enregistrement actif est déplacée vers l'arrière (vers le début du jeu d'enregistrements).

Si l'appel de la méthode Move déplace la position de l'enregistrement actif vers un point situé avant le premier enregistrement, ADO place automatiquement l'enregistrement actif à la position précédant le premier enregistrement dans l'objet Recordset (la propriété BOF a la valeur True ). Si vous tentez un déplacement vers l'arrière lorsque la propriété BOF a déjà la valeur True, une erreur est générée.

Si l’appel de la méthode Move déplace la position de l’enregistrement actif vers un point situé après le dernier enregistrement, ADO place automatiquement l’enregistrement actif à la position suivant le dernier enregistrement dans l’objet Recordset (la propriété EOF a la valeur True). Si vous tentez un déplacement vers l’avant lorsque la propriété EOF a déjà la valeur True, une erreur est générée.

L'appel de la méthode Move à partir d'un objet Recordset vide génère une erreur.

Si vous passez un signet dans l’argument Start, le déplacement est effectué par rapport à l’enregistrement affecté de ce signet, en supposant que l’objet Recordset prenne les signets en charge. Les signets sont définis par l’intermédiaire de la propriété Bookmark. Si aucun signet n'est spécifié, le déplacement s'applique à l'enregistrement actif.

Si vous utilisez la propriété CacheSize pour mettre en cache localement les enregistrements du fournisseur, le passage d’un argument NumRecords qui déplace la position d’enregistrement actuelle en dehors du groupe actif d’enregistrements mis en cache force ADO à récupérer un nouveau groupe d’enregistrements, à partir de l’enregistrement de destination. La propriété CacheSize détermine la taille du groupe qui vient d’être récupéré, et l’enregistrement de destination est le premier enregistrement récupéré.