Propriedade Index
Indica o nome do índice 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 base subjacente ao objeto Recordset. Ou seja, o índice deve ter sido declarado programaticamente como um objeto Index do ADOX ou quando a tabela base foi criada.
Um erro em tempo de execução ocorrerá se não for possível definir o índice. A propriedade Index não pode ser definida sob as seguintes condições:
Em um manipulador de eventos WillChangeRecordset ou RecordsetChangeComplete.
Se Recordset ainda estiver executando uma operação (que pode ser determinada pela propriedade State).
Se um filtro tiver sido definido no Recorset com a propriedade Filter.
A propriedade Index sempre poderá ser definida com êxito se o Recordset for fechado, mas o Recordset não abrirá com êxito, ou o índice não será utilizável, se o provedor subjacente não oferecer suporte a índices.
Se o índice puder ser definido, a posição da linha atual poderá ser alterada. Isso causará uma atualização para a propriedade AbsolutePosition e disparará os 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 provedor subjacente não oferecer suporte à propriedade Index e, portanto, o método Seek, considere usar o método Find. Determine se o objeto Recordset dá suporte a índices com o método Supports(adIndex).
A propriedade Index interna não está relacionada à propriedade Optimize dinâmica, embora ambas lidem com índices.
Aplica-se A
Consulte Também
Exemplo da propriedade Index e do método Seek (VB)
Objeto Index (ADOX)
Método Seek