ReadyState 属性 (RDS)

指示 DataControl 对象在将数据检索到其 Recordset 对象时的进度。

重要

从 Windows 8 和 Windows Server 2012 开始,Windows 操作系统不再包含 RDS 服务器组件(有关更多详细信息,请参阅 Windows 8 和 Windows Server 2012 兼容性实用手册)。 Windows 的未来版本中将移除 RDS 客户端组件。 请避免在新的开发工作中使用该功能,并着手修改当前还在使用该功能的应用程序。 使用 RDS 的应用程序应迁移到 WCF 数据服务

设置和返回值

设置或返回以下值之一。

说明
adcReadyStateLoaded 当前查询仍在执行,并且未提取任何行。 DataControl 对象的记录集不可用。
adcReadyStateInteractive 当前查询检索到的一组初始行已存储在 DataControl 对象的记录集中,可供使用。 剩余的行仍在提取中。
adcReadyStateComplete 当前查询检索到的所有行都已存储在 DataControl 对象的记录集中并且可供使用。

如果操作由于错误而中止,或者如果 Recordset 对象未初始化,则此状态也会存在。

注意

每个使用这些常量的客户端可执行文件都必须为其提供声明。 可以从位于 RDS 库默认安装文件夹中的文件 Adcvbs.inc 剪切并粘贴所需的常量声明。

备注

使用 onReadyStateChange 事件监视异步查询操作期间 ReadyState 属性的变化。 这比定期检查属性的值更有效。

如果在异步操作期间发生错误,ReadyState 属性将更改为 adcReadyStateComplete,State 属性从 adStateExecuting 更改为 adStateClosed,并且 Recordset 对象 Value 属性保持为 Nothing。

应用于

DataControl 对象 (RDS)

另请参阅

ReadyState 属性示例 (VBScript)
Cancel 方法 (RDS)
ExecuteOptions 属性 (RDS)