共用方式為

Index 屬性

  • 發行項

指出目前對 Recordset 物件有效的索引名稱。

設定和傳回值

設定或傳回一個字串值，指出索引的名稱。

備註

Index 屬性所命名的索引必須已在 Recordset 物件下的基底資料表上宣告。 也就是說，索引必須已用程式設計方式宣告為 ADOX Index 物件，或已在基底資料表建立時宣告。

如果無法設定索引，將會發生執行階段錯誤。 Index 屬性無法在下列情況下設定：

  • 在 WillChangeRecordset 或 RecordsetChangeComplete 事件處理常式內。

  • 如果資料錄集仍在執行作業 (可從 State 屬性確認)。

  • 如果已使用 Filter 屬性在資料錄集上設定篩選。

當資料錄集關閉時，Index 屬性一律可以成功設定，但如果基礎提供者不支援索引，資料錄集就無法成功開啟，或索引將無法使用。

如果可以設定索引，則目前的資料列位置可能會變更。 這會導致 AbsolutePosition 屬性更新，並引發 WillChangeRecordset、RecordsetChangeComplete、WillMove 和 MoveComplete 事件。

如果可以設定索引，且 LockType 屬性為 adLockPessimistic 或 adLockOptimistic，則會執行隱含的 UpdateBatch 作業。 這會釋放目前和受影響的群組。 任何現有的篩選都會釋放，而目前的資料列位置會變更為重新排序的資料錄集的第一個資料列。

Index 屬性會與 Seek 方法搭配使用。 如果基礎提供者不支援 Index 屬性，因而不支援 Seek 方法，請考慮改用 Find 方法。 使用 Supports(adIndex) 方法確認 Recordset 物件是否支援索引。

內建的 Index 屬性與動態 Optimize 屬性都會處理索引，但兩者無關。

套用至

Recordset 物件 (ADO)

另請參閱

Seek 方法和 Index 屬性範例 (VB)
Index 物件 (ADOX)
Seek 方法