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 屬性都會處理索引,但兩者無關。