CompareBookmarks-Methode (ADO)

  • Artikel

Vergleicht zwei Lesezeichen und gibt einen Hinweis auf ihre relativen Werte zurück.

Syntax

  
result = recordset.CompareBookmarks(Bookmark1, Bookmark2)

Rückgabewert

Gibt einen CompareEnum-Wert zurück, der die relative Zeilenposition zweier Datensätze angibt, die durch ihre Lesezeichen dargestellt werden.

Parameter

Bookmark1
Das Lesezeichen der ersten Zeile.

Bookmark2
Das Lesezeichen der zweiten Zeile.

Bemerkungen

Die Lesezeichen müssen auf dasselbe Recordset-Objekt oder ein Recordset-Objekt und dessen Klon angewendet werden. Sie können keine Lesezeichen aus verschiedenen Recordset-Objekten verlässlich vergleichen, auch wenn sie aus derselben Quelle oder mit demselben Befehl erstellt wurden. Sie können auch keine Lesezeichen für ein Recordset-Objekt vergleichen, dessen zugrunde liegender Anbieter keine Vergleiche unterstützt.

Ein Lesezeichen identifiziert eindeutig eine Zeile in einem Recordset-Objekt. Verwenden Sie die Bookmark-Eigenschaft der aktuellen Zeile, um das Lesezeichen abzurufen.

Da der Datentyp eines Lesezeichens für jeden Anbieter spezifisch ist, macht ADO es als Variant verfügbar. Beispielsweise sind SQL Server-Lesezeichen vom Typ DBTYPE_R8 (Double). ADO macht diesen Typ als Variant mit dem Untertyp Double verfügbar.

Beim Vergleichen von Lesezeichen versucht ADO keine Art von Koersion. Die Werte werden einfach an den Anbieter übergeben, bei dem der Vergleich stattfindet. Wenn die Lesezeichen, die an die CompareBookmarks-Methode übergeben werden, in Variablen unterschiedlicher Typen gespeichert werden, kann der folgende Fehler zu nicht übereinstimmenden Typen generiert werden: „Arguments are of the wrong type, are out of the acceptable range, or are in conflict with each other.“ (Argumente weisen den falschen Typ auf, befinden sich außerhalb des akzeptablen Bereichs oder widersprechen einander.).

Ein Lesezeichen, das ungültig oder falsch formatiert ist, führt zu einem Fehler.

Gilt für

Recordset-Objekt (ADO)

Weitere Informationen

CompareBookmarks-Methode – Beispiel (VB)
CompareBookmarks-Methode – Beispiel (VC++)
Bookmark-Eigenschaft (ADO)