WillExecute イベント (ADO)

WillExecute イベントは、保留中のコマンドが接続で実行される直前に呼び出されます。

構文

  
WillExecute Source, CursorType, LockType, Options, adStatus, pCommand, pRecordset, pConnection  

パラメーター

ソース
SQL コマンドまたはストアド プロシージャ名を含む String。

CursorType
開かれる Recordset のカーソルの種類を含む CursorTypeEnum。 このパラメーターを使用すると、RecordsetOpen Method (ADO Recordset) 操作中にカーソルを任意の種類に変更できます。 CursorType は、他の操作では無視されます。

LockType
開かれる Recordset のロックの種類を含む LockTypeEnum。 このパラメーターを使用すると、RecordsetOpen 操作中にロックを任意の種類に変更できます。 LockType は、他の操作では無視されます。

[オプション]
コマンドを実行するかまたは Recordset を開くために使用できるオプションを示す Long 値。

adStatus
このイベントが呼び出されたときに adStatusCantDeny または adStatusOK になる可能性がある EventStatusEnum 状態値。 これが adStatusCantDeny である場合、このイベントは保留中の操作の取り消しを要求できません。

pCommand
このイベント通知が適用される Command Object (ADO) オブジェクト。

pRecordset
このイベント通知が適用される Recordset Object (ADO) オブジェクト。

pConnection
このイベント通知が適用される Connection Object (ADO) オブジェクト。

注釈

WillExecute イベントは、Connection が原因で発生する可能性があります。 Execute Method (ADO Connection)、Execute Method (ADO Command)、または Open Method (ADO Recordset) メソッド: pConnection パラメーターには、常に Connection オブジェクトへの有効な参照が含まれている必要があります。 イベントの原因が Connection.Execute である場合、pRecordset パラメーターと pCommand パラメーターは Nothing に設定されます。 イベントの原因が Recordset.Open である場合、pRecordset パラメーターは Recordset オブジェクトを参照し、pCommand パラメーターは Nothing に設定されます。 イベントの原因が Command.Execute である場合、pCommand パラメーターは Command オブジェクトを参照し、pRecordset パラメーターは Nothing に設定されます。

WillExecute を使用すると、保留中の実行パラメーターを調べて変更できます。 このイベントは、保留中のコマンドを取り消す要求を返す場合があります。

注意

Command の元のソースが、CommandStream Property (ADO) プロパティによって指定されたストリームである場合は、WillExecuteSource パラメーターに新しい文字列を割り当てると、Command のソースが変更されます。 CommandStream プロパティがクリアされ、CommandText Property (ADO) プロパティが新しいソースで更新されます。 CommandStream によって指定された元のストリームは、解放され、アクセスできなくなります。

新しいソース文字列の言語が、(CommandStream に対応する) Dialect Property プロパティの元の設定と異なる場合は、pCommand によって参照されるコマンド オブジェクトの Dialect プロパティを設定して、正しい言語を指定する必要があります。

参照

ADO イベント モデルの例 (VC++)
ADO イベント ハンドラーの概要
Connection オブジェクト (ADO)