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


Свойство Index

Указывает имя индекса, действующего в настоящее время для объекта 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 , хотя оба они имеют дело с индексами.

Применение

Объект Recordset (ADO)

См. также:

Seek Method and Index Property Example (VB)
Объект Index (ADOX)
Метод Seek