Index 属性

指示当前对 Recordset 对象有效的索引的名称。

设置和返回值

设置或返回一个 String 值,该值是索引的名称。

备注

由 Index 属性命名的索引先前必须已在 Recordset 对象所基于的基表上进行声明。 也就是说,索引必须以编程方式声明为 ADOX Index 对象,或者在创建基表时进行声明。

如果无法设置索引,则会发生运行时错误。 在下列情况下,无法设置 Index 属性:

  • WillChangeRecordset 或 RecordsetChangeComplete 事件处理程序中。

  • 如果 Recordset 仍在执行操作(可由 State 属性确定)。

  • 如果已在 Recordset 上使用 Filter 属性设置了筛选器。

如果 Recordset 已关闭,但无法成功打开 Recordset,或者在基础提供程序不支持索引的情况下无法使用该索引,那么始终可成功设置 Index 属性。

如果可设置索引,则当前行位置可能会更改。 这将导致更新 AbsolutePosition 属性,并将触发 WillChangeRecordset、RecordsetChangeComplete、WillMoveMoveComplete 事件。

如果可设置索引,并且 LockType 属性为 adLockPessimistic 或 adLockOptimistic,则执行隐式的 UpdateBatch 操作。 这会释放当前组和受影响的组。 会释放任何现有筛选器,并将当前行位置更改为重新排序的 Recordset 的第一行。

Index 属性与 Seek 方法结合使用。 如果基础提供程序不支持 Index 属性,进而不支持 Seek 方法,请考虑改用 Find 方法。 确定 Recordset 对象是否支持采用 Supports(adIndex) 方法的索引。

内置的 Index 属性与动态 Optimize 属性无关,尽管它们都处理索引。

应用于

记录集对象 (ADO)

另请参阅

Seek 方法和 Index 属性示例 (VB)
索引对象 (ADOX)
Seek 方法