ADO WillExecute 和 ExecuteComplete 事件
定義和用法
事件是某個(gè)具體的操作發(fā)生后被自動(dòng)調(diào)用的子例程。
- WillExecute 事件在調(diào)用 objcomm.Execute, objconn.Execute 或者 objrs.Open 之前會(huì)被觸發(fā)
- ExecuteComplete 事件會(huì)在完成對(duì) objcomm.Execute, objconn.Execute, objrs.Open, objrs.Requery 或 objrs.NextRecordset 的調(diào)用之后被觸發(fā)
語(yǔ)法
WillExecute src,cursortyp,locktyp,options,status,objcomm,objrs,objconn ExecuteComplete recaffected,objerror,status,objcomm,objrs,objconn
參數(shù) | 描述 |
---|---|
src | 字符串,包含 SQL 命令或存儲(chǔ)過(guò)程名稱(chēng)。 |
cursortyp | 規(guī)定要使用的游標(biāo)類(lèi)型。CursorTypeEnum 值之一。 |
locktyp | 規(guī)定要使用的鎖定類(lèi)型。LockTypeEnum 值之一。 |
options | 一個(gè)或多個(gè) CommandTypeEnum 或 ExecuteOptionEnum 值 |
recaffected | Long 值,該命令影響的記錄的數(shù)目。 |
objerror |
包含已發(fā)生的錯(cuò)誤的 Error 對(duì)象。
注釋?zhuān)篍ventStatusEnum 值必須被設(shè)置為 adStatusErrorsOccurred,以創(chuàng)建該 Error 對(duì)象。 |
status | 一個(gè) EventStatusEnum 值。 |
objcomm |
對(duì)于 WillExecute:如果此事件由 Command.Execute 引發(fā),objcomm 參數(shù)將引用 Command 對(duì)象,objrs 參數(shù)將設(shè)置為 Nothing。 對(duì)于 ExecuteComplete:被執(zhí)行的 Command 對(duì)象。 |
objrs |
對(duì)于 WillExecute:如果此事件由 Recordset.Open 引發(fā),objrs 參數(shù)將引用 Recordset 對(duì)象,pCommand 參數(shù)將設(shè)置為 Nothing。 對(duì)于 ExecuteComplete:Recordset 對(duì)象,是命令執(zhí)行的結(jié)果。 |
objconn | 與命令執(zhí)行相關(guān)聯(lián)的 Connection 對(duì)象。 |
EventStatusEnum 值
常量 | 值 | 描述 |
---|---|---|
adStatusOK | 1 | 引發(fā)該事件的操作成功。 |
adStatusErrorsOccurred | 2 | 引發(fā)該事件的操作失敗。 |
adStatusCantDeny | 3 | 不能取消掛起操作。 |
adStatusCancel | 4 | 取消導(dǎo)致事件發(fā)生的操作。 |
adStatusUnwantedEvent | 5 | 在事件方法執(zhí)行結(jié)束之前禁止后續(xù)的通知。 |