Compartilhar via

Propriedade Index

  • Artigo

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

Objeto Recordset (ADO)

Consulte Também

Exemplo da propriedade Index e do método Seek (VB)
Objeto Index (ADOX)
Método Seek