Seek メソッド (ADO)

  • [アーティクル]

適用先: Access 2013、Office 2013

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

構文

recordset。SeekKeyValues、 SeekOption

パラメーター

パラメーター 説明
KeyValues バリアント型 ( Variant ) の値の配列。 インデックスは 1 つまたは複数の列から成るため、対応する各列と比較する値をこの配列に格納します。
SeekOption インデックスの各列とそれに対応する KeyValues の比較に使用する比較の種類を指定する SeekEnum 値。

注釈

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

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

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

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