Move, méthode (ADO)

S’applique à : Access 2013, Office 2013

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

Syntaxe

recordset. Déplacer numRecords, Démarrer

Paramètres

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 de l'enregistrement actif est avancée (vers la fin du jeu d'enregistrements). Si l'argument NumRecords est inférieur à zéro, la position de l'enregistrement actif est déplacée vers l'arrière (vers le début du jeu d'enregistrements).

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

Si l’appel de la méthode Move déplace la position de l’enregistrement vers un point situé après le dernier enregistrement, ADO définit la position de l’enregistrement actif après le dernier enregistrement du jeu d’enregistrements (la propriété EOF a la valeur True). Une tentative de déplacement vers l’avant 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ébut, le déplacement est effectué par rapport à l'enregistrement affecté de ce signet, pour autant que l'objet Recordset prenne en charge les signets. S'il n'est pas spécifié, le déplacement est effectué par rapport à 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 actuelle en dehors du groupe actif 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 qui vient d’être récupéré, et l’enregistrement de destination est le premier enregistrement récupéré.

Si l’objet Recordset peut être déplacé vers l’avant uniquement, un utilisateur peut néanmoins passer un argument NbEnregistrements inférieur à zéro, pour autant que la destination fasse partie du jeu actif d’enregistrements mis en cache. Si l’appel de la méthode Move déplace la position d’enregistrement actif vers un enregistrement placé 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 bi-directionnel sur un fournisseur qui ne prend en charge que le défilement avant. Dans la mesure où les enregistrements mis en cache sont chargés en mémoire, évitez de mettre en cache plus d'enregistrements qu'il n'est nécessaire. Même si un objet Recordset avant seulement peut prendre en charge ce type de déplacement arrière, l'appel de la méthode MovePrevious sur un objet Recordset avant seulement génère néanmoins une erreur.