次の方法で共有

WillExecute イベント (ADO)

  • [アーティクル]

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

構文

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

パラメーター

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

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

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

オプションの
コマンドの実行または Recordsetの開き方に使用できるオプションを示す 長い 値です。

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

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

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

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

備考

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

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

手記

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

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

関連項目

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