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