ReadyState プロパティ (RDS)
Recordset オブジェクトにデータを取得する DataControl オブジェクトの進行状況を示します。
大事な
Windows 8 および Windows Server 2012 以降では、RDS サーバー コンポーネントは Windows オペレーティング システムに含まれません (詳細については、Windows 8 と Windows Server 2012 の互換性クックブック を参照してください)。 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 オブジェクト Value プロパティは Nothingのままです。
適用対象
関連項目
ReadyState プロパティの使用例 (VBScript)
Cancel メソッド (RDS)
ExecuteOptions プロパティ (RDS)