Metodo CompareBookmarks (ADO)

Confronta due segnalibri e restituisce un'indicazione dei valori relativi.

Sintassi

  
result = recordset.CompareBookmarks(Bookmark1, Bookmark2)  

Valore restituito

Restituisce un valore CompareEnum che indica la posizione di riga relativa di due record rappresentati dai relativi segnalibri.

Parametri

Segnalibro1
Segnalibro della prima riga.

Segnalibro2
Segnalibro della seconda riga.

Osservazioni

I segnalibri devono essere applicati allo stesso oggetto Recordset o a un oggetto Recordset e al relativo clone. Non è possibile confrontare in modo affidabile i segnalibri da oggetti Recordset diversi, anche se sono stati creati dallo stesso comando o origine. Non è inoltre possibile confrontare i segnalibri per un oggetto Recordset il cui provider sottostante non supporta i confronti.

Un segnalibro identifica in modo univoco una riga in un oggetto Recordset. Utilizzare la proprietà Bookmark della riga corrente per ottenere il relativo segnalibro.

Poiché il tipo di dati di un segnalibro è specifico per ogni provider, ADO lo espone come Variant. Ad esempio, i segnalibri di SQL Server sono di tipo DBTYPE_R8 (Double). ADO espone questo tipo come Variant con un sottotipo Double.

Quando si confrontano i segnalibri, ADO non tenta alcun tipo di coercizione. I valori vengono semplicemente passati al provider dove si verifica il confronto. Se i segnalibri passati al metodo CompareBookmarks vengono archiviati in variabili di tipi diversi, può essere generato il seguente errore di mancata corrispondenza del tipo: "Gli argomenti sono di tipo errato, non rientrano nell'intervallo accettabile o sono in conflitto tra loro".

Un segnalibro non valido o formato in modo non corretto genererà un errore.

Si applica a

Oggetto Recordset (ADO)

Vedere anche

Esempio del metodo CompareBookmarks (VB)
Esempio del metodo CompareBookmarks (VC++)
Proprietà Bookmark (ADO)