Propriedade Index (ADO)
Aplica-se ao: Access 2013, Office 2013
Indica o nome do índice que está atualmente em vigor para um objeto Recordset.
Configurações e valores retornados
Define ou retorna um valor String, que é o nome do índice.
Comentários
O índice nomeado pela propriedade Index deve ter sido declarado anteriormente na tabela de base subjacente ao objeto Recordset. Ou seja, o índice deve ter sido declarado de forma programática como um objeto Index do ADOX ou quando a tabela de base foi criada.
Um erro de tempo de execução ocorrerá se o índice não puder ser definido. A propriedade Index não poderá ser definida:
Dentro de um manipulador de eventos WillChangeRecordset ou RecordsetChangeComplete.
Se o Recordset ainda estiver executando uma operação (o que pode ser determinado pela propriedade State).
Se um filtro tiver sido definido no Recordset com a propriedade Filter.
A propriedade Index sempre poderá ser definida com sucesso se o Recordset estiver fechado, mas o Recordset não será aberto com sucesso, ou o índice não poderá ser usado, se o provedor de base não oferecer suporte a índices.
Se o índice puder ser definido, a posição da linha atual poderá ser alterada. Isso atualizará a propriedade AbsolutePosition e a geração dos eventos WillChangeRecordset, RecordsetChangeComplete, WillMove e MoveComplete.
Se o índice puder ser definido e a propriedade LockType for adLockPessimistic ou adLockOptimistic, uma operação UpdateBatch implícita será executada. Isso libera os grupos atuais e afetados. Qualquer filtro existente é liberado, e a posição da linha atual é alterada para a primeira linha do Recordset reordenado.
A propriedade Index é usada em conjunto com o método Seek. Se o provedorde base não oferecer suporte à propriedade Index e, consequentemente, ao método Seek, considere o uso do método Find. Determine se o objeto Recordset dá suporte a índices com o método Supports(adIndex).
A propriedade interna Index não está relacionada à propriedade Optimize dinâmica, embora as duas lidem com índices.