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 | 在事件方法执行结束之前禁止后续的通知。 |