ADO Connection イベントと Recordset イベント

Connection オブジェクトと Recordset オブジェクトの 2 つの ADO オブジェクトがイベントを発生させることができます。 ConnectionEvent ファミリは Connection オブジェクトに対する操作に関連し、RecordsetEvent ファミリは Recordset オブジェクトに対する操作に関連します。

  • Connection イベント: イベントは、接続上のトランザクションが開始されるとき、コミットされるとき、またはロールバックされるときに発行されます。あるいは、Command が実行されるとき、Connection イベント操作中に警告が発生するとき、または Connection が開始されるかまたは終了するときに発行されます。

  • Recordset イベント: イベントは、非同期フェッチ操作に関連して発行されます。あるいは、Recordset オブジェクトの行の間を移動するとき、Recordset の行内のフィールドを変更するとき、Recordset 内の行を変更するとき、サーバー側カーソルを使用して Recordset を開くとき、Recordset を閉じるとき、または、Recordset の何らかの内容に変更を加えるときに発行されます。

次の表は、イベントとその説明をまとめたものです。

ConnectionEvent 説明
BeginTransComplete、CommitTransComplete、RollbackTransComplete トランザクション管理 - 接続上の現在のトランザクションが開始された、コミットされた、またはロールバックされたことを示す通知。
WillConnectConnectComplete、Disconnect 接続管理 - 現在の接続が開始される、開始された、または終了したことを示す通知。
WillExecuteExecuteComplete コマンド実行管理 - 接続上の現在のコマンドの実行が開始されるかまたは終了したことを示す通知。
InfoMessage 情報 - 現在の操作に関する追加情報があることを示す通知。
RecordsetEvent 説明
FetchProgressFetchComplete 取得状態 - データ取得操作の進行状況、または取得操作が完了したことを示す通知。 これらのイベントは、クライアント側カーソルを使用して Recordset が開かれた場合にのみ使用できます。
WillChangeField、FieldChangeComplete フィールド変更管理 - 現在のフィールドの値が変更されるかまたは変更されたことを示す通知。
WillMove、MoveCompleteEndOfRecordset ナビゲーション管理 - Recordset 内の現在の行位置が変更される、変更された、または Recordset の末尾に達したことを示す通知。
WillChangeRecord、RecordChangeComplete 行変更管理 - Recordset の現在の行の内容が変更されるかまたは変更されたことを示す通知。
WillChangeRecordset、RecordsetChangeComplete Recordset 変更管理 - 現在の Recordset の内容が変更されるかまたは変更されたことを示す通知。

参照

言語別の ADO イベントのインスタンス化ADO のイベントイベント パラメーター複数のイベント ハンドラーの連携方法イベントの種類