CompareBookmarks, méthode (ADO)

S’applique à : Access 2013, Office 2013

Compare deux signets et retourne une indication de leurs valeurs relatives.

Syntaxe

Résultat = recordset. CompareBookmarks(Bookmark1, Bookmark2)

Valeur renvoyée

Retourne une valeur CompareEnum qui indique la position de ligne relative de deux enregistrements représentée par leur signet.

Paramètres

Remarques

Les signets doivent s'appliquer au même objet Recordset ou à un objet Recordset et à son clone. Vous ne pouvez pas comparer correctement des signets issus d'objets Recordset différents, même s'ils ont été créés à partir de la même source ou commande. Vous ne pouvez pas non plus comparer des signets d'un objet Recordset dont le fournisseur sous-jacent ne prend pas en charge les comparaisons.

Un signet constitue l'identification unique d'une ligne dans un objet Recordset. Utilisez la propriété Bookmark de la ligne active pour obtenir son signet.

Comme le type de données d'un signet est propre au fournisseur, ADO l'expose en tant que type Variant. Par exemple, les signets SQL Server sont de type DBTYPE_R8 (Double). ADO l'expose en tant que type Variant avec le sous-type Double.

Lorsqu'il compare des signets, ADO ne tente aucune forme de conversion forcée. Les valeurs sont tout simplement passées au fournisseur lors de la comparaison. Si les signets passés à la méthode CompareBookmarks sont stockés dans des variables de types différents, cela peut générer une erreur d'incompatibilité de type indiquant que les arguments n'ont pas le type approprié, qu'ils sont en dehors de la plage acceptable ou qu'ils sont en conflit.

Un signet qui n'est pas valide ni correctement formé génère une erreur.