Поделиться через

Свойство Index (ADO)

  • Статья

Область применения: Access 2013, Office 2013

Указывает имя индекса, действующего в настоящее время для объекта Recordset .

Параметры и возвращаемые значения

Задает или возвращает строковое значение, которое является именем индекса.

Замечания

Индекс, именуемый свойством Index , должен быть ранее объявлен в базовой таблице, лежащей в основе объекта Recordset . То есть индекс должен быть объявлен программным способом либо как объект ИНДЕКСА ADOX, либо при создании базовой таблицы.

Если невозможно задать индекс, возникнет ошибка во время выполнения. Невозможно задать свойство Index :

  • В обработчике событий WillChangeRecordset или RecordsetChangeComplete .

  • Если набор записей по-прежнему выполняет операцию (которую можно определить с помощью свойства State ).

  • Значение , если в наборе записей задан фильтр со свойством Filter .

Свойство Index всегда можно задать успешно, если набор записей закрыт, но набор записей не откроется успешно или индекс не будет использоваться, если базовый поставщик не поддерживает индексы.

Если индекс можно задать, текущая позиция строки может измениться. Это приведет к обновлению свойства AbsolutePosition и возникновению событий WillChangeRecordset, RecordsetChangeComplete, WillMove и MoveComplete .

Если индекс можно задать и свойство LockType имеет тип adLockPessimistic или adLockOptimistic, то выполняется неявная операция UpdateBatch . Это освобождает текущие и затронутые группы. Любой существующий фильтр освобождается, а текущая позиция строки изменяется на первую строку переупорядоченного набора записей.

Свойство Index используется в сочетании с методом Seek . Если базовый поставщик не поддерживает свойство Index и, следовательно, метод Seek , рассмотрите возможность использования метода Find . Определите, поддерживает ли объект Recordset индексы с помощью метода Supports(adIndex).

Встроенное свойство Index не связано с динамическим свойством Optimize , хотя оба они имеют дело с индексами.