ADO WillExecute と ExecuteComplete イベント

定義と使用法

イベントは特定の操作が発生した後に自動的に呼び出されるサブルーチンです。

WillExecute イベントは objcomm.Execute、objconn.Execute または objrs.Open の前にトリガーされます。
ExecuteComplete イベントは objcomm.Execute、objconn.Execute、objrs.Open、objrs.Requery、または objrs.NextRecordset の呼び出しが完了した後にトリガーされます。

WillExecute src,cursortyp,locktyp,options,status,objcomm,objrs,objconn
ExecuteComplete recaffected,objerror,status,objcomm,objrs,objconn

パラメータ	説明
src	SQL コマンドまたはストレージプロシージャの名前を含む文字列。
cursortyp	使用するカーソルタイプを指定します。CursorTypeEnum 値のうちの一つ。
locktyp	使用するロックタイプを指定します。LockTypeEnum 値のうちの一つ。
options	一つまたは複数の CommandTypeEnum または ExecuteOptionEnum 値
recaffected	Long 値、このコマンドが影響するレコードの数。
objerror	発生したエラーを含む Error オブジェクト。注記：EventStatusEnum 値は adStatusErrorsOccurred に設定されなければなりません、この Error オブジェクトを作成するために。
status	一つの EventStatusEnum 値。
objcomm	WillExecuteに対して：このイベントが Command.Execute によって引き起こされた場合、objcomm パラメータは Command オブジェクトを参照し、objrs パラメータは Nothing に設定されます。 ExecuteCompleteに対して：実行された Command オブジェクト。
objrs	WillExecute：このイベントが Recordset.Open によって引き起こされた場合、objrs パラメータはレコードセットオブジェクトを参照し、pCommand パラメータは Nothing に設定されます。 ExecuteComplete：レコードセットオブジェクトは、コマンド実行の結果です。
objconn	コマンド実行に関連付けられた Connection オブジェクト。

定数	値	説明
adStatusOK	1	このイベントを引き起こした操作が成功しました。
adStatusErrorsOccurred	2	このイベントを引き起こした操作が失敗しました。
adStatusCantDeny	3	一時停止中の操作をキャンセルすることはできません。
adStatusCancel	4	イベント発生を引き起こした操作をキャンセルします。
adStatusUnwantedEvent	5	イベントメソッドの実行が終わる前に、後続の通知を禁止します。