WillExecute 事件 (ADO)

只會在暫止命令於連線上執行之前，呼叫 WillExecute 事件。

語法

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

參數

來源
String 值，其中包含 SQL 命令或預存程序名稱。

CursorType
CursorTypeEnum，其中包含將開啟的 Recordset 的資料指標類型。 使用此參數，您可以在 RecordsetOpen 方法 (ADO Recordset) 作業期間，將資料指標變更為任何類型。 其他任何作業都會忽略 CursorType。

LockType
LockTypeEnum，其中包含將開啟的 Recordset 的鎖定類型。 使用此參數，您可以在 RecordsetOpen 作業期間，將鎖定變更為任何類型。 其他任何作業都會忽略 LockType。

選項
Long 值，表示可以用來執行命令或開啟 Recordset 的選項。

adStatus
EventStatusEnum 狀態值，呼叫此事件時，該值可能是 adStatusCantDeny 或 adStatusOK 如果其為 adStatusCantDeny，此事件可能無法要求取消暫止作業。

pCommand
套用此事件通知的 Command 物件 (ADO) 物件。

pRecordset
套用此事件通知的 Recordset 物件 (ADO) 物件。

pConnection
套用此事件通知的 Connection 物件 (ADO) 物件。

備註

WillExecute 事件可能由於 Connection 而發生。 Execute 方法 (ADO 連線)、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 可讓您檢查並修改暫止的執行參數。 此事件可能會傳回一個取消暫止命令的要求。

注意

如果 Command 的原始來源是 CommandStream 屬性 (ADO) 屬性所指定的串流，則將新的字串指派給 WillExecuteSource 參數會變更 Command 的來源。 CommandStream屬性將被清除，且 CommandText 屬性 (ADO) 屬性將會以新的來源更新。 CommandStream 指定的原始串流將會釋出，而且無法存取。

如果新來源字串的方言不同於 Dialect 屬性 (對應至 CommandStream) 的原始設定不同，則必須藉由設定pCommand 所參考 Command 物件的 Dialect 屬性來指定正確的方言。

另請參閱

ADO 事件模型範例 (VC++)
ADO 事件處理常式摘要
Connection 物件 (ADO)