Move, méthode (ADO)

Déplace la position de l’enregistrement actif dans un objet Recordset .

Syntaxe

  
recordset.Move NumRecords, Start  

Paramètres

NumRecords
Expression Long signée qui spécifie le nombre d’enregistrements déplacés par la position de l’enregistrement actif.

Start
facultatif. Valeur string ou Variant qui prend la valeur d’un signet. Vous pouvez également utiliser une valeur BookmarkEnum .

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 le 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 le 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 l'argument Démarrer, le déplacement est relatif à l'enregistrement avec ce signet, en supposant que l'objet Recordset supporte les signets. 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é.

Si l’objet Recordset est transféré uniquement, un utilisateur peut toujours passer un argument NumRecords inférieur à zéro, à condition que la destination se trouve dans l’ensemble actuel d’enregistrements mis en cache. Si l’appel Move déplace la position d’enregistrement active vers un enregistrement avant le premier enregistrement mis en cache, une erreur se produit. Par conséquent, vous pouvez utiliser un cache d’enregistrements qui prend en charge le défilement complet sur un fournisseur qui prend uniquement en charge le défilement avant. Étant donné que les enregistrements mis en cache sont chargés en mémoire, vous devez éviter de mettre en cache plus d’enregistrements que nécessaire. Même si un objet Recordset avant seul prend en charge les déplacements vers l’arrière de cette façon, l’appel de la méthode MovePrevious sur n’importe quel objet Recordset avant seul génère toujours une erreur.

Notes

La prise en charge de la migration vers l’arrière dans un Recordset avant uniquement n’est pas prévisible, selon votre fournisseur. Si l’enregistrement actif a été positionné après le dernier enregistrement du Recordset, il se peut que le déplacement vers l’arrière n’entraîne pas la position actuelle correcte.

S'applique à

Recordset, objet (ADO)

Voir aussi

Move, exemple de méthode (VB)
Move, exemple de méthode (VBScript)
Move, exemple de méthode (VC++)
MoveFirst, MoveLast, MoveNext et MovePrevious, méthodes (ADO)
MoveFirst, MoveLast, MoveNext et MovePrevious, méthodes (RDS)
MoveRecord, méthode (ADO)