(PWS4 IIS4 IIS5)
CompareBookmarks — 2 つのブックマークを比較して、相対的な位置を示す値を返します。
構文
result = recordset.CompareBookmarks(Bookmark1, Bookmark2)
パラメータ
- Bookmark1
- 最初の行のブックマークを指定します。
- Bookmark2
- 2 番目の行のブックマークを指定します。
戻り値
ブックマークで表される 2 つのレコードの行位置の相対的な関係を示す CompareEnum 値を返します。
説明
ブックマークは、同じ Recordset オブジェクト、または Recordset オブジェクトとそのクローンに適用する必要があります。異なる Recordset オブジェクトのブックマークを比較した場合、同じソースまたはコマンドで作成されたブックマークであっても、信頼できる結果は得られません。また、 Recordset オブジェクトの基になるプロバイダがブックマークの比較をサポートしていない場合も同様です。
ブックマークは、Recordset オブジェクトの行を一意に識別します。ブックマークを取得するには、カレント行の Bookmark プロパティを使います。
ブックマークのデータ型はプロバイダ固有であるため、データ型はバリアント型で表されます。たとえば、SQL Server のブックマークは、DBTYPE_R8 型 (倍精度浮動小数点数型) です。ADO では、このデータ型は、サブタイプが倍精度浮動小数点型のバリアント型として表されます。
ブックマークを比較するときには、 ADO はどんな種類の強制試行も行いません。値は、そのまま比較が行われるプロバイダに渡されます。CompareBookmarks メソッドに渡されるブックマークに、異なる型の変数が格納されている場合、「引数が間違った型、許容範囲外、または競合しています。」という型不一致エラーが発生します。
無効なブックマークや、不正に作成されたブックマークは、エラーの原因になります。