Propriedade ReadyState (RDS)

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

Importante

A partir do Windows 8 e do Windows Server 2012, os componentes do servidor RDS não estão mais incluídos no sistema operacional Windows (confira Windows 8 e Manual de Compatibilidade do Windows Server 2012 para obter mais detalhes). Os componentes do cliente RDS serão removidos em uma versão futura do Windows. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam. Os aplicativos que usam o RDS devem migrar para o Serviço de Dados do WCF.

Configurações e valores retornados

Define ou retorna um dos valores a seguir.

Valor	Descrição
adcReadyStateLoaded	A consulta atual ainda está em execução e nenhuma linha foi buscada. O Recordset do objeto DataControl não está disponível para uso.
adcReadyStateInteractive	Um conjunto inicial de linhas recuperadas pela consulta atual foi armazenado no Recordset do objeto DataControl e está disponível para uso. As linhas restantes ainda estão sendo buscadas.
adcReadyStateComplete	Todas as linhas recuperadas pela consulta atual foram armazenadas no Recordset do objeto DataControl e estão disponíveis para uso. Esse estado também existirá se uma operação for anulada devido a um erro ou se o objeto Recordset não for inicializado.

Observação

Cada arquivo executável do lado do cliente que usa essas constantes precisa fornecer declarações para eles. Você pode cortar e colar as declarações constantes desejadas no arquivo Adcvbs.inc, localizado na pasta de instalação padrão da biblioteca do RDS.

Comentários

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

Se ocorrer um erro durante uma operação assíncrona, a propriedade ReadyState será alterada para adcReadyStateComplete, a propriedade State mudará de adStateExecuting para adStateClosed e a propriedade Value do objeto Recordset permanecerá Nothing.

Aplica-se A

Objeto DataControl (RDS)

Consulte Também

Exemplo do método ReadyState (VBScript)
Método Cancel (RDS)
Propriedade ExecuteOptions (RDS)