Partage via


CompareBookmarks, méthode (ADO)

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

Syntaxe

  
result = recordset.CompareBookmarks(Bookmark1, Bookmark2)  

Valeur de retour

Retourne 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.

Remarques

Les signets doivent s’appliquer au même objet Recordset, ou à un objet Recordset et à son cloner. Vous ne pouvez pas comparer de manière fiable les signets provenant de différents Recordset objets, même s’ils ont été créés à partir de la même source ou de la même commande. Vous ne pouvez pas non plus 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 active pour obtenir son signet.

Étant donné que 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 aucun type de forçage. Les valeurs sont simplement transmises au fournisseur où se produit la comparaison. Si les signets passés à la méthode CompareBookmarks sont stockés dans des variables de types différents, il peut générer l’erreur d’incompatibilité de type suivante : « 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 formé de manière incorrecte entraîne une erreur.

S’applique à

objet Recordset (ADO)

Voir aussi

CompareBookmarks, méthode - Exemple (VB)
CompareBookmarks, méthode - Exemple (VC++)
Bookmark, propriété (ADO)