MoveFirst, MoveLast, MoveNext et MovePrevious, méthodes (ADO)
Passe au premier enregistrement, dernier, suivant ou précédent dans un objet Recordset spécifié et fait de cet enregistrement l’enregistrement actif.
Syntaxe
recordset.{MoveFirst | MoveLast | MoveNext | MovePrevious}
Remarques
Utilisez la méthode MoveFirst pour déplacer la position d’enregistrement actuelle vers le premier enregistrement du jeu d’enregistrements .
Utilisez la méthode MoveLast pour déplacer la position d’enregistrement actuelle vers le dernier enregistrement du jeu d’enregistrements . L’objet Recordset doit prendre en charge les signets ou le mouvement du curseur vers l’arrière ; sinon, l’appel de méthode génère une erreur.
Un appel à MoveFirst ou MoveLast lorsque le jeu d’enregistrements est vide ( BOF et EOF sont vrais) génère une erreur.
Utilisez la méthode MoveNext pour déplacer la position d’enregistrement actuelle vers l’avant (vers le bas du jeu d’enregistrements ). Si le dernier enregistrement est l’enregistrement actif et que vous appelez la méthode MoveNext, ADO définit l’enregistrement actif sur 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.
Dans ADO 2.5 et versions ultérieures, lorsque le jeu d’enregistrements a été filtré ou trié et que les données de l’enregistrement actif sont modifiées, l’appel de la méthode MoveNext déplace le curseur deux enregistrements à partir de l’enregistrement actif. Cela est dû au fait que lorsque l’enregistrement actif est modifié, l’enregistrement suivant devient le nouvel enregistrement actif. Appel de MoveNext après que la modification déplace le curseur un enregistrement vers l’avant à partir du nouvel enregistrement actif. Cela diffère du comportement dans ADO 2.1 et versions antérieures. Dans ces versions antérieures, la modification des données d’un enregistrement actif dans le jeu d’enregistrements trié ou filtré ne modifie pas la position de l’enregistrement actif et MoveNext déplace le curseur vers l’enregistrement suivant immédiatement après l’enregistrement actif.
Utilisez la méthode MovePrevious pour déplacer la position d’enregistrement actuelle vers l’arrière (vers le haut du jeu d’enregistrements ). L’objet Recordset doit prendre en charge les signets ou le mouvement du curseur vers l’arrière ; sinon, l’appel de méthode génère une erreur. Si le premier enregistrement est l’enregistrement actif et que vous appelez la méthode MovePrevious, 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’objet Recordset ne prend pas en charge les signets ou le déplacement du curseur vers l’arrière, la méthode MovePrevious génère une erreur.
Si le jeu d’enregistrements est transféré uniquement et que vous souhaitez prendre en charge le défilement vers l’avant et vers l’arrière, vous pouvez utiliser la propriété CacheSize pour créer un cache d’enregistrements qui prendra en charge le déplacement vers l’arrière du curseur via la méthode Move . É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. Vous pouvez appeler la méthode MoveFirst dans un objet records et de avant uniquement ; Cela peut entraîner la réexécutation de la commande par le fournisseur qui a généré l’objet Recordset.
S’applique à
Voir aussi
MoveFirst, MoveLast, MoveNext et MovePrevious, méthodes - Exemple (VB)
MoveFirst, MoveLast, MoveNext et MovePrevious, méthodes - Exemple (VBScript)
MoveFirst, MoveLast, MoveNext et MovePrevious, méthodes - Exemple (VC++)
Move, méthode (ADO)
MoveFirst, MoveLast, MoveNext et MovePrevious, méthodes (RDS)
MoveRecord, méthode (ADO)