ADO イベント ハンドラーの概要

適用先: Access 2013、Office 2013

イベントを発行できる ADO オブジェクトは、Connection オブジェクトと Recordset オブジェクトの 2 つです。 ConnectionEvent 系は Connection オブジェクトの操作に関係し、 RecordsetEvent 系は Recordset オブジェクトの操作に関係します。

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

• Recordset Events: Recordset オブジェクトの行内での移動時、 Recordset の行内のフィールド変更時、 Recordset の行の変更時、サーバー側カーソルで Recordset を開いたとき、 Recordset を閉じたとき、または Recordset 内で変更が行われたとき、および非同期のフェッチ操作に関連してもイベントが発行されます。

次の表は、イベントとその説明の一覧です。

ConnectionEvent	説明
BeginTransComplete、CommitTransComplete、RollbackTransComplete	トランザクション管理 接続上でカレント トランザクションが開始されたこと、コミットされたこと、またはロール バックされたことを通知します。
WillConnect、ConnectComplete、Disconnect	接続管理 現在の接続がこれから開始されること、開始されたこと、または終了したことを通知します。
WillExecute、 ExecuteComplete	コマンド実行管理 接続上で現在のコマンドの実行がこれから開始されること、または終了したことを通知します。
Infomessage	情報 現在の操作についての詳細な情報があることを通知します。

RecordsetEvent	説明
FetchProgress、FetchComplete	取得状況 データ取得操作が進行中であること、または完了したことを通知します。 これらのイベントは、Recordset がクライアント側カーソルを使用して開かれたときにのみ利用できます。
WillChangeField、FieldChangeComplete	フィールド変更管理 現在のフィールド値をこれから変更すること、または変更したことを通知します。
WillMove、MoveComplete、 EndOfRecordset	移動管理Recordset でのカレント行の位置をこれから変更すること、変更が完了したこと、または Recordset の最後に達したことを通知します。
WillChangeRecord、RecordChangeComplete	行変更管理Recordset のカレント行の内容をこれから変更すること、または変更したことを通知します。
WillChangeRecordset、RecordsetChangeComplete	Recordset 変更管理 現在の Recordset の内容をこれから変更すること、または変更したことを通知します。