(PWS4 IIS4 IIS5)
Seek — Recordset のインデックスを検索して指定値と一致する行をすばやく検索し、カレント行の位置をその行に変更します。
構文
recordset.Seek KeyValues, SeekOption
パラメータ
- recordset
- Recordset オブジェクを指定します。
- KeyValues
- バリアント型 (Variant) の値の配列を指定します。インデックスは、1 つまたは複数の列で構成されているため、この配列には、インデックスの各列と照合するための値を指定します。
- SeekOption
- インデックスの各列とそれに対応する KeyValues を比較するときの、比較の種類を SeekEnum 値で指定します。
戻り値
値を返しません。
説明
基になるプロバイダが Recordset オブジェクトのインデックスをサポートしている場合は、Seek メソッドを Index プロパティと組み合わせて使用します。基になるプロバイダが Seek をサポートしているかどうかを判別するには、Supports(adSeek) メソッドを使用します。プロバイダがインデックスをサポートしているかどうかを判別するには、Supports(adIndex) メソッドを使用します。Microsoft OLE DB Provider for Microsoft Jet は、Seek および Index をサポートしています。
Seek メソッドで求める行が見つからない場合、エラーは発生せず、行の位置は Recordset の最後になります。このメソッドを実行する前に、必要なインデックスを Index プロパティに設定してください。
このメソッドは、サーバー側のカーソルでのみサポートされます。Recordset オブジェクトの CursorLocation プロパティの値が adUseClient の場合、Seek はサポートされません。
このメソッドは、CommandTypeEnum に adCmdTableDirect を指定して Recordset オブジェクトを開いている場合にのみ使用できます。