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