ADO WillExecute 和 ExecuteComplete 事件

定义和用法

事件是某个具体的操作发生后被自动调用的子例程。

  • WillExecute 事件在调用 objcomm.Execute, objconn.Execute 或者 objrs.Open 之前会被触发
  • ExecuteComplete 事件会在完成对 objcomm.Execute, objconn.Execute, objrs.Open, objrs.Requery 或 objrs.NextRecordset 的调用之后被触发

语法

  1. WillExecute src,cursortyp,locktyp,options,status,objcomm,objrs,objconn
  2.  
  3. 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 在事件方法执行结束之前禁止后续的通知。