ReadyState プロパティ (RDS)

       

DataControl オブジェクトがデータを取得して Recordset オブジェクトに格納するときの、進行状況を示します。

設定値と戻り値

次のいずれかの値を設定、または返します。

説明
adcReadyStateLoaded カレント クエリは実行中で、行はまだフェッチされていません。RDS.DataControl オブジェクトの Recordset は使えません。
adcReadyStateInteractive カレント クエリが取得する最初の行セットは、DataControl オブジェクトの Recordset に格納され、使用可能です。残りの行はフェッチ中です。
adcReadyStateComplete カレント クエリが取得した行は、DataControl オブジェクトの Recordset にすべて格納され、使用可能です。

エラーで処理が打ち切られた場合や、Recordset オブジェクトが初期化されていない場合にもこの状態になります。


注意   これらの定数を使うクライアント側の各実行可能ファイルは、その定数を宣言する必要があります。C:\Program Files\Common Files\System\MSADC フォルダの Adcvbs.inc ファイルから、定数の宣言をコピーして貼り付けることができます。

解説

非同期クエリ操作の実行時に ReadyState プロパティの変更を監視するには、onReadyStateChange イベントを使います。プロパティの値を定期的に確認するよりもこの方法が効率的です。

非同期操作の途中でエラーが発生すると、ReadyState プロパティは adcReadyStateComplete に変更され、State プロパティは adStateExecuting から adStateClosed に変更され、Recordset オブジェクトの Value プロパティは Nothing のまま変更されません。