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 (consulte o Windows 8 e o Windows Server 2012 Compatibility Cookbook para obter mais detalhes). Os componentes do cliente RDS serão removidos em uma versão futura do Windows. Evite usar esse recurso em um novo trabalho de desenvolvimento e planeje modificar aplicativos que atualmente usam esse recurso. Os aplicativos que usam RDS devem migrar para WCF Data Service.
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 do não está disponível para uso. |
| adcReadyStateInteractive | Um conjunto inicial de linhas recuperadas pela consulta atual foi armazenado no recordset do objeto Data Control 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. |
Nota
Cada arquivo executável do lado do cliente que usa essas constantes deve fornecer declarações para eles. Você pode recortar e colar as declarações constantes desejadas no arquivo Adcvbs.inc, localizado na pasta de instalação padrão da biblioteca RDS.
Observações
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 periodicamente o valor da propriedade.
Se ocorrer um erro durante uma operação assíncrona, a propriedade ReadyState muda para adcReadyStateComplete, a propriedade State muda de adStateExecuting para adStateClosed e o objeto Recordset Value permanece Nothing.
Aplica-se a
Consulte Também
exemplo da propriedade ReadyState (VBScript)
do Método de Cancelamento de (RDS)
da Propriedade ExecuteOptions (RDS)