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