Seek メソッド

  • [アーティクル]

Recordset のインデックスを検索して、指定された値に一致する行をすばやく見つけ出し、現在の行の位置をその行に変更します。

構文

  
recordset.Seek KeyValues, SeekOption

パラメーター

KeyValues
Variant 値の配列。 インデックスは 1 つ以上の列で構成され、配列には対応する各列と比較する値が含まれています。

SeekOption
インデックスの列と対応する KeyValue の間で行う比較の種類を指定する SeekEnum 値。

注釈

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

Seek で目的の行が見つからない場合、エラーは発生せず、行はレコードセットの末尾に配置されます。 このメソッドを実行する前に、Index プロパティを目的のインデックスに設定します。

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

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

適用対象

Recordset オブジェクト (ADO)

参照

Seek メソッドおよび Index プロパティの例 (VB)
Seek メソッドおよび Index プロパティの例 (VC++)
Find メソッド (ADO)
Index プロパティ