CompareBookmarks メソッド (ADO)

適用先: Access 2013、Office 2013

2 つのブックマークを比較して、相対的な位置を示す値を返します。

構文

結果 = recordset。CompareBookmarks(Bookmark1, Bookmark2)

戻り値

ブックマークで表される 2 つのレコードの相対的な行位置を示す CompareEnum 値を返します。

パラメーター

注釈

ブックマークは、同じ Recordset オブジェクト、または Recordset オブジェクトとその 複製に適用する必要があります。 異なる Recordset オブジェクトのブックマークを比較した場合、同じソースまたはコマンドから作成されたブックマークであっても、信頼できる結果は得られません。 また、基になるプロバイダーがブックマークの比較をサポートしていない Recordset オブジェクトの場合も、ブックマークを比較できません。

ブックマークは、 Recordset オブジェクトの行を一意に識別します。 カレント行のブックマークを取得するには、カレント行の Bookmark プロパティを使用します。

ブックマークのデータ型はプロバイダー固有であり、ADO ではバリアント (Variant) 型として公開されます。 たとえば、SQL Server のブックマークは DBTYPE_R8 型 (倍精度浮動小数点数型) です。 ADO では、このデータ型は、サブタイプが倍精度浮動小数点型のバリアント型として表されます。

ブックマークを比較する場合、ADO はいかなる種類の強制も試みません。 値は、比較が行われるプロバイダーに渡されるだけです。 CompareBookmarks メソッドに渡されたブックマークが異なる型の変数に格納されている場合は、型の不一致エラー "引数は間違った型、許容範囲外、または相互に競合しています" というエラーが発生する可能性があります。

無効なブックマークや、形式が正しくないブックマークは、エラーの原因になります。