CompareBookmarks, méthode (ADO)

  • Article

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

Syntaxe

  
result = recordset.CompareBookmarks(Bookmark1, Bookmark2)

Valeur de retour

Renvoie une valeur CompareEnum qui indique la position de ligne relative de deux enregistrements représentés par leurs signets.

Paramètres

Signet1
Signet de la première ligne.

Signet2
Signet de la deuxième ligne.

Notes

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

Un signet identifie de manière unique une ligne dans un objet Recordset. Utilisez la propriété Bookmark de la ligne actuelle pour obtenir son signet.

Puisque le type de données d’un signet est spécifique à chaque fournisseur, ADO l’expose en tant que Variant. Par exemple, les signets SQL Server sont de type DBTYPE_R8 (Double). ADO expose ce type en tant que Variant avec un sous-type de Double.

Lors de la comparaison des signets, ADO ne tente aucune forme de forçage de type. Les valeurs sont simplement transmises au fournisseur où se produit la comparaison. Si les signets transmis à la méthode CompareBookmarks sont stockés dans des variables de types différents, l’erreur d’incompatibilité de type suivante peut être générée : « Les arguments sont de type incorrect, sont hors de la plage acceptable ou sont en conflit entre eux. »

Un signet qui n’est pas valide ou mal formé déclenche une erreur.

S'applique à

Recordset, objet (ADO)

Voir aussi

CompareBookmarks, exemple de méthode (VB)
CompareBookmarks, exemple de méthode (VC++)
Bookmark, propriété (ADO)