Établissement d'un record

La méthode Move vous permet de progresser ou reculer dans le jeu d’enregistrements un nombre spécifié d’enregistrements à l’aide de la syntaxe suivante :

oRs.Move NumRecords, Start  

Remarques

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

Si l’argument NumRecords est supérieur à zéro, la position actuelle de l'enregistrement avance (en direction de la fin du jeu d'enregistrements ). Si NumRecords est inférieur à zéro, la position de l’enregistrement actuel se déplace vers l’arrière (vers le début du jeu d’enregistrements ).

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

Si l’appel Move déplace la position de l’enregistrement courant à un point après le dernier enregistrement, ADO place l’enregistrement courant à la position après le dernier enregistrement dans le jeu d’enregistrements (EOF est True). Une tentative de progression lorsque la propriété EOF est déjà 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 Démarrer, le déplacement est relatif à l’enregistrement avec ce signet, en supposant que l’objet Recordset supporte les signets. Un signet est obtenu à l’aide de la propriété Signet. 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, transmettez un argument NumRecords qui déplace la position d’enregistrement actuelle en dehors du groupe actuel 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 nouvellement récupéré et l’enregistrement de destination est le premier enregistrement récupéré.