Seek メソッド

Recordset のインデックスを検索して指定値と一致する行をすばやく検索し、カレント行の位置をその行に変更します。

構文

recordset.Seek KeyValues, SeekOption

パラメータ

KeyValues   バリアント型 (Variant) の値の配列を指定します。インデックスは、1 つまたは複数の列で構成されており、この配列には、インデックスの各列と照合するための値を指定します。

SeekOption   インデックスの各列とそれに対応する KeyValues を比較するときの、比較の種類を SeekEnum 値で指定します。

解説

基になるプロバイダが Recordset オブジェクトのインデックスをサポートしている場合は、Seek メソッドを Index プロパティと組み合わせて使用します。基になるプロバイダが Seek をサポートしているかどうかを判別するには、Supports(adSeek) メソッドを使用します。プロバイダがインデックスをサポートしているかどうかを判別するには、Supports(adIndex) メソッドを使用します。OLE DB Provider for Microsoft Jet は、Seek および Index をサポートしています。

Seek メソッドで求める行が見つからない場合、エラーは発生せず、行の位置は Recordset の最後になります。このメソッドを実行する前に、必要なインデックスを Index プロパティに設定してください。

このメソッドは、サーバー側のカーソルでのみサポートされます。Recordset オブジェクトの CursorLocation プロパティの値が adUseClient の場合、Seek はサポートされません。

このメソッドは、Recordset オブジェクトが、CommandTypeEnum 値の adCmdTableDirect で開かれている場合にのみ使用できます。