ReadyState 属性 （RDS）

指出 DataControl 對象的進度，因為它會將數據擷取到其 Recordset 物件中。

重要

從 Windows 8 和 Windows Server 2012 開始，RDS 伺服器元件已不再包含在 Windows 作業系統中（如需詳細資訊，請參閱 Windows 8 和 Windows Server 2012 兼容性 Cookbook）。 RDS 用戶端元件將在未來的 Windows 版本中移除。 請避免在新的開發工作中使用此功能，並計劃修改目前使用此功能的應用程式。 使用 RDS 的應用程式應該移至 WCF Data Service。

設定和傳回值

設定或傳回下列其中一個值。

價值	描述
adcReadyStateLoaded	目前的查詢仍在執行中，而且尚未擷取任何數據列。 DataControl 物件的 Recordset 無法使用。
adcReadyStateInteractive	目前查詢所擷取的初始數據列集已儲存在 DataControl 物件的 Recordset，而且可供使用。 其餘的數據列仍在擷取中。
adcReadyStateComplete	目前查詢擷取的所有數據列都儲存在 DataControl 物件的 Recordset，並可供使用。 如果作業因為錯誤而中止，或未初始化 Recordset 物件，則此狀態也會存在。

注意

使用這些常數的每個用戶端可執行檔都必須為其提供宣告。 您可以從位於 RDS 連結庫的預設安裝資料夾中的 Adcvbs.inc 檔案剪下並貼上所需的常數宣告。

言論

使用 onReadyStateChange 事件，在異步查詢作業期間監視 ReadyState 屬性中的變更。 這比定期檢查 屬性的值更有效率。

如果在異步操作期間發生錯誤， ReadyState 屬性會變更為 adcReadyStateComplete，State 属性會從 adStateExecuting 變更為 adStateClosed，而 Recordset object Value 属性會維持 Nothing。

適用於

DataControl 物件 （RDS）

另請參閱

ReadyState 屬性範例 （VBScript）
Cancel 方法 （RDS）
ExecuteOptions 屬性 （RDS）