Accès à un enregistrement

La méthode Move vous permet d’avancer ou de revenir vers l’arrière dans l’objet Recordset d’un nombre spécifié d’enregistrements à l’aide de la syntaxe suivante :

oRs.Move NumRecords, Start  

Notes

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 se déplace vers l’avant (vers la fin du Recordset). Si NumRecords est inférieur à zéro, la position d’enregistrement actuelle se déplace vers l’arrière (vers le début du Recordset).

Si l’appel Move déplace la position d’enregistrement actuelle vers un point avant le premier enregistrement, ADO définit l’enregistrement actif sur la position avant le premier enregistrement dans l’objet Recordset (BOF est True). Une tentative de déplacement vers l’arrière lorsque la propriété BOF a déjà la valeur True génère une erreur.

Si l’appel Move déplace la position d’enregistrement actuelle vers un point après le dernier enregistrement, ADO définit l’enregistrement actif à la position après le dernier enregistrement dans l’objet Recordset (EOF est True). Une tentative d’avancer lorsque la propriété EOF a déjà la valeur True génère une erreur.

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 relatif à l’enregistrement avec ce signet, en supposant que l’objet Recordset prend en charge les signets. Un signet est obtenu à l’aide de la propriété Bookmark. S’il n’est pas spécifié, le déplacement est relatif à 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 active en dehors du groupe actuel d’enregistrements mis en cache force ADO à récupérer un nouveau groupe d’enregistrements, en commençant par l’enregistrement de destination. La propriété CacheSize détermine la taille du groupe nouvellement récupéré, et l’enregistrement de destination est le premier enregistrement récupéré.