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