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.

Observações

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 ADOX Index ou quando a tabela base foi criada.

Um erro em tempo de execução ocorrerá se o índice não puder ser definido. A propriedade Index não pode ser definida nas seguintes condições:

• Dentro de um manipulador de eventos WillChangeRecordset ou RecordsetChangeComplete .

• Se o Conjunto de Registros ainda estiver executando uma operação (que pode ser determinada pela propriedade State ).

• Se um filtro tiver sido definido no Conjunto de Registros com a propriedade Filter .

A propriedade Index sempre poderá ser definida com êxito se o Conjunto de Registros for fechado, mas o Conjunto de Registros 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 Conjunto de Registros reordenado.

A propriedade Index é usada em conjunto com o método Seek . Se o provedor subjacente não der 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 otimização dinâmica, embora ambas lidem com índices.

Aplica-se a

do objeto Recordset (ADO)

Consulte Também

Exemplo da propriedade Seek Method and Index (VB)
do objeto Index (ADOX)
método Seek