Méthodes MoveFirst, MoveLast, MoveNext et MovePrevious (ADO)

Passe au premier enregistrement, dernier, suivant ou précédent dans un objet Recordset spécifié et rend cet enregistrement actif.

Syntaxe

  
recordset.{MoveFirst | MoveLast | MoveNext | MovePrevious}  

Notes

Utilisez la méthode MoveFirst pour déplacer la position d’enregistrement active vers le premier enregistrement dans le Recordset.

Utilisez la méthode MoveLast pour déplacer la position d’enregistrement active vers le premier enregistrement dans le Recordset. L’objet Recordset doit prendre en charge les signets ou le déplacement du curseur vers l’arrière ; sinon, l’appel de méthode génère une erreur.

Un appel à MoveFirst ou MoveLast lorsque l’objet Recordset est vide (BOF et EOF ont la valeur True) génère une erreur.

Utilisez la méthode MoveNext pour déplacer la position d’enregistrement actuelle d’un enregistrement vers l’avant (vers le bas du Recordset). 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 l’objet Recordset (EOF a la valeur True). Une tentative d’avancer lorsque la propriété EOF a déjà la valeur True génère une erreur.

Dans ADO 2.5 et versions ultérieures, lorsque le Recordset 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 vers l’avant à partir de l’enregistrement actif. En effet, 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 d’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 Recordset triés ou filtrés 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 Recordset). L’objet Recordset doit prendre en charge les signets ou le déplacement 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 sur la position avant le premier enregistrement dans l’objet Recordset (BOF a la valeur 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’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 Recordset est vers l’avant uniquement et que vous souhaitez prendre en charge le défilement 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 Recordset avant seul ; cela peut entraîner la réexécutation de la commande qui a généré l’objet Recordset.

S'applique à

Recordset, objet (ADO)

Voir aussi

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