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 longue signée qui spécifie le nombre d’enregistrements déplacés par la position d’enregistrement actuelle.
démarrer
Optionnel. Valeur string ou Variant qui prend la valeur d’un signet. Vous pouvez également utiliser une valeur BookmarkEnum.
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 d’enregistrement actuelle avance (vers 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 sur 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 Déplacer 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 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 l’argument Démarrer, le déplacement est relatif à l’enregistrement avec ce signet, en supposant que l’objet Recordset prend en charge 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, 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é.
Si l’objet recordset est transféré uniquement, un utilisateur peut toujours passer un NumRecords argument inférieur à zéro, à condition que la destination se trouve dans l’ensemble actuel d’enregistrements mis en cache. Si le Déplacer appel déplacerait la position d’enregistrement actuelle 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 vers l’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 en avant uniquement 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 vers l’avant uniquement génère toujours une erreur.
Note
La prise en charge de la migration vers l’arrière dans un jeu d’enregistrements vers l’avant uniquement n’est pas prévisible, selon votre fournisseur. Si l’enregistrement actif a été positionné après le dernier enregistrement dans le jeu d’enregistrements , Déplacer vers l’arrière peut ne pas entraîner la position actuelle correcte.
S’applique à
Voir aussi
Move, méthode - Exemple (VB)
Move, méthode - Exemple (VBScript)
Move, méthode - Exemple (VC++)
MoveFirst, MoveLast, MoveNext et MovePrevious, méthodes (ADO)
MoveFirst, MoveLast, MoveNext et MovePrevious, méthodes (RDS)
MoveRecord, méthode (ADO)