Compartilhar via


Propriedade ReadyState (RDS)

Aplica-se ao: Access 2013, Office 2013

Indica o progresso de um objeto DataControl à medida que ele recupera dados em seu objeto Recordset.

Configurações e valores retornados

Define ou retorna um dos seguintes valores.

Valor

Descrição

adcReadyStateLoaded

A consulta atual ainda está sendo executada e nenhuma linha foi pesquisada. O Recordset do objeto DataControl não está disponível para uso.

adcReadyStateInteractive

Um conjunto inicial de linhas recuperado pela consulta atual foi armazenado no Recordset do objeto DataControl e está disponível para uso. As linhas restantes ainda estão sendo pesquisadas.

adcReadyStateComplete

Todas as linhas recuperadas pela consulta atual foram armazenadas no Recordset do objeto DataControl e estão disponíveis para uso. Este estado também é possível se uma operação for anulada devido a um erro ou se o objeto Recordset não for inicializado.

Observação

[!OBSERVAçãO] Cada arquivo executável do lado do cliente que utilizar essas constantes deverá fornecer suas respectivas declarações. Você pode recortar e colar as declarações da constante que deseja do arquivo Adcvbs.inc, localizado na pasta C:\Arquivos de Programas\Arquivos Comuns\System\MSADC.

Comentários

Utilize o evento onReadyStateChange para monitorar as alterações da propriedade ReadyState durante uma operação de consulta assíncrona. Esse procedimento é mais eficiente do que verificar periodicamente o valor da propriedade.

Se ocorrer um erro durante uma operação assíncrona, a propriedade ReadyState será alterada para adcReadyStateComplete, a propriedade Statemudará de adStateExecuting para adStateClosed e a propriedade Valor do objeto Recordsetpermanecerá Nothing.