共用方式為


WillExecute 事件 (ADO)

WillExecute 事件會在連接上執行暫止命令之前呼叫。

語法

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

參數

來源
包含 SQL 命令或預存程式名稱的 String

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

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

選項
Long 值,指出可用來執行命令或開啟 Recordset的選項。

adStatus
呼叫此事件時,EventStatusEnum 狀態值,adStatusCantDenyadStatusOK。 如果它 adStatusCantDeny,則此事件可能不會要求取消暫止的作業。

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

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

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

言論

WillExecute 事件可能會因為 Connection 而發生。 Execute 方法 (ADO Connection)Execute 方法 (ADO Command)Open 方法 (ADO Recordset) 方法:pConnection 參數應一律包含 Connection 物件的有效參考。 如果事件是由於 connection.Execute ,則 pRecordsetpCommand 參數會設定為 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 參考之命令物件的 Dialect 屬性來指定正確的方言。

另請參閱

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