Toggle navigation

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一个或多个CommandTypeEnumExecuteOptionEnum
recaffectedLong 值,该命令影响的记录的数目。
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 值

常量描述
adStatusOK1引发该事件的操作成功。
adStatusErrorsOccurred2引发该事件的操作失败。
adStatusCantDeny3不能取消挂起操作。
adStatusCancel4取消导致事件发生的操作。
adStatusUnwantedEvent5在事件方法执行结束之前禁止后续的通知。