ReadyState 屬性 (RDS)
表示 DataControl 物件的進度,因為其會將資料擷取到其 Recordset 物件中。
重要
從 Windows 8 和 Windows Server 2012 開始,Windows 作業系統中不再包含 RDS 伺服器元件 (請參閱 Windows 8 和 Windows Server 2012 相容性操作手冊以取得詳細資訊)。 未來的 Windows 版本將移除 RDS 用戶端元件。 請避免在新的開發工作中使用這項功能,並規劃修改目前使用這項功能的應用程式。 使用 RDS 的應用程式應該移轉至 WCF 資料服務。
設定和傳回值
設定或傳回下列其中一個值。
值 | 描述 |
---|---|
adcReadyStateLoaded | 目前的查詢仍在執行中,而且尚未擷取任何資料列。 DataControl 物件的 Recordset 無法使用。 |
adcReadyStateInteractive | 目前查詢所擷取的初始資料列集已儲存在 DataControl 物件的 Recordset 中,而且可供使用。 剩餘的資料列仍在擷取中。 |
adcReadyStateComplete | 目前查詢所擷取的資料列已儲存在 DataControl 物件的 Recordset 中,而且可供使用。 如果作業因為錯誤而中止,或 Recordset 物件未初始化,則也會有此狀態。 |
注意
使用這些常數的每個用戶端可執行檔都必須為其提供宣告。 您可以從 Adcvbs.inc 檔案剪下並貼上您想要的常數宣告,該檔案位於 RDS 程式庫的預設安裝資料夾中。
備註
使用 onReadyStateChange 事件,在非同步查詢作業期間監視 ReadyState 屬性的變更。 這比定期檢查屬性值更有效率。
如果在非同步作業期間發生錯誤,ReadyState 屬性會變更為 adcReadyStateComplete、State 屬性會從 adStateExecuting 變更為 adStateClosed,而 Recordset 物件的 Value 屬性會維持 Nothing。
套用至
另請參閱
ReadyState 屬性範例 (VBScript)
Cancel 方法 (RDS)
ExecuteOptions 屬性 (RDS)