Index プロパティ
Recordset オブジェクトに対して現在有効なインデックスの名前を示します。
設定と戻り値
インデックスの名前 文字列 値を設定または返します。
備考
Index プロパティによって指定されたインデックスは、Recordset オブジェクトの基になるベース テーブルで以前に宣言されている必要があります。 つまり、インデックスは、ADOX Index オブジェクトとして、またはベース テーブルが作成されたときにプログラムによって宣言されている必要があります。
インデックスを設定できない場合は、実行時エラーが発生します。 Index プロパティは、次の条件では設定できません。
WillChangeRecordset 内または RecordsetChangeComplete イベント ハンドラー。
Recordset がまだ操作を実行している場合 (State プロパティによって決定できます)。
Filter プロパティを使用して、Recordset にフィルターが設定されている場合。
Recordset プロパティは、Recordset が閉じられているが、Recordset が正常に開かないか、基になるプロバイダーがインデックスをサポートしていない場合は、インデックスを使用できない場合に、常に正常に設定できます。
インデックスを設定できる場合は、現在の行の位置が変更される可能性があります。 これにより、AbsolutePosition プロパティが更新され、WillChangeRecordset、RecordsetChangeComplete、WillMove、MoveComplete イベントが発生します。
インデックスを設定でき、LockType プロパティが adLockPessimistic または adLockOptimistic 場合は、UpdateBatch 操作 暗黙的に実行されます。 これにより、現在のグループと影響を受けるグループが解放されます。 既存のフィルターが解放され、現在の行位置が並べ替え済みのレコードセット の最初の行変更されます。
Index プロパティは、Seek メソッドと組み合わせて使用します。 基になるプロバイダーが Index プロパティをサポートしていないため、Seek メソッドがサポートされていない場合は、代わりに Find メソッドを使用することを検討してください。 Supports(adIndex) メソッドを使用して、Recordset オブジェクトがインデックスをサポートしているかどうかを判断します。
組み込みの Index プロパティは、動的な Optimize プロパティとは関係ありませんが、どちらもインデックスを扱います。
適用対象
関連項目
Seek メソッドと Index プロパティの使用例 (VB)
Index オブジェクト (ADOX)
Seek メソッドの