Partager via


Bookmark, propriété (ADO)

Indique un signet qui identifie de manière unique l’enregistrement actif dans un objet Recordset ou définit l’enregistrement actif dans un objet Recordset sur l’enregistrement identifié par un signet valide.

Paramètres et valeurs de retour

Définit ou renvoie une expression Variant qui prend la valeur d’un signet valide.

Notes

Utilisez la propriété Bookmark pour enregistrer la position de l’enregistrement actif et revenir à cet enregistrement à tout moment. Les signets sont disponibles uniquement dans les objets Recordset qui prennent en charge les fonctionnalités de signet.

Lorsque vous ouvrez un objet Recordset, chacun de ses enregistrements a un signet unique. Pour enregistrer le signet de l’enregistrement actif, affectez la valeur de la propriété Bookmark à une variable. Pour revenir rapidement à cet enregistrement à tout moment après le passage à un autre enregistrement, définissez la propriété Bookmark de l’objet Recordset sur la valeur de cette variable.

L’utilisateur peut ne pas être en mesure d’afficher la valeur du signet. En outre, les utilisateurs ne doivent pas s’attendre à ce que les signets soient directement comparables, car deux signets faisant référence au même enregistrement peuvent avoir des valeurs différentes.

Si vous utilisez la méthode Clone pour créer une copie d’un objet Recordset, les paramètres de propriété Bookmark pour les objets Recordset d’origine et dupliqués sont identiques et vous pouvez les utiliser de manière interchangeable. Toutefois, vous ne pouvez pas utiliser de signets provenant d’objets Recordset différents de manière interchangeable, même s’ils ont été créés à partir de la même source ou de la même commande.

Notes

Utilisation du service de données à distance Lorsqu’elle est utilisée sur un objet Recordset côté client, la propriété Bookmark est toujours disponible.

S'applique à

Recordset, objet (ADO)

Voir aussi

BOF, EOF et Bookmark, exemple de propriétés (VB)
Exemple de propriétés BOF, EOF et Bookmark (VC++)
Supports, méthode