Proprietà Index

Indica il nome dell'indice attualmente attivo per un oggetto Recordset.

Impostazioni e valori restituiti

Imposta o restituisce un valore String che corrisponde al nome dell'indice.

Osservazioni

L'indice denominato dalla proprietà Index deve essere stato dichiarato in precedenza nella tabella di base sottostante l'oggetto Recordset. Ovvero, l'indice deve essere stato dichiarato a livello di codice come oggetto Index di ADOX o quando è stata creata la tabella di base.

Se non è possibile impostare l'indice, si verificherà un errore di run-time. Non è possibile impostare la proprietà Index nelle condizioni seguenti:

• All'interno di un gestore eventi WillChangeRecordset o RecordsetChangeComplete.

• Se l'oggetto Recordset sta ancora eseguendo un'operazione (determinabile dalla proprietà State).

• Se è stato impostato un filtro sull'oggetto Recordset con la proprietà Filter.

La proprietà Index può essere sempre impostata correttamente se l'oggetto Recordset è chiuso, ma l'oggetto Recordset non verrà aperto correttamente, oppure l'indice non sarà utilizzabile se il provider sottostante non supporta gli indici.

Se è possibile impostare l'indice, la posizione della riga corrente può cambiare. Verrà generato un aggiornamento per la proprietà AbsolutePosition e verranno attivati gli eventi WillChangeRecordset, RecordsetChangeComplete, WillMove e MoveComplete.

Se l'indice può essere impostato e il valore della proprietà LockType è adLockPessimistic o adLockOptimistic, viene eseguita un'operazione UpdateBatch implicita. Tale operazione rilascia i gruppi correnti e interessati. Viene rilasciato qualsiasi filtro esistente e la posizione della riga corrente viene modificata nella prima riga dell'oggetto Recordset riordinato.

La proprietà Index viene usata insieme al metodo Seek. Se il provider sottostante non supporta la proprietà Index e di conseguenza il metodo Seek, è invece consigliabile usare il metodo Find. Determinare se l'oggetto Recordset supporta gli indici con il metodo Supports(adIndex).

La proprietà Index predefinita non è correlata alla proprietà Optimize dinamica, anche se entrambi gestiscono gli indici.

Si applica a

Oggetto Recordset (ADO)

Vedere anche

Esempio del metodo Seek e della proprietà Index (VB)
Oggetto Index (ADOX)
Metodo Seek