日期:2012-06-14  浏览次数:20886 次

WillExecute (ConnectionEvent) 方法


该方法在对该连接执行挂起命令之前调用,并允许用户检查和修改挂起的执行参数。该方法可返回取消挂起命令的请求。

语法

WillExecute Source, CursorType, LockType, Options, adStatus, pCommand, pRecordset, pConnection

参数

Source 字符串,包含 SQL 命令或存储的过程名称。

CursorType CursorTypeEnum,包含用于将要打开的记录集的游标类型。使用该参数,可以在 Recordset Open 操作期间,将游标更改为任何类型。对于其他任何操作,将忽略 CursorType。

LockType LockTypeEnum,包含将要打开的记录集的锁定类型。使用该参数,可以在 Recordset Open 操作期间,更改对任何类型的锁定。对于其他任何操作,将忽略 LockType。

Options 长整型选项,可用于执行命令或打开记录集。

adStatus EventStatusEnum 状态值,在调用该方法时它可以是 adStatusCantDeny 或 adStatusOK。如果它是 adStatusCantDeny,该方法可能无法请求取消挂起操作。

在此方法返回前,将该参数设置为 adStatusUnwantedEvent 可以避免后续的通知,或者设置为 adStatusCancel 以请求取消引发该事件的操作。

pCommand 该事件通知所针对的 Command 对象。

pRecordset 该事件通知所针对的 Recordset 对象。

pConnection 该事件通知所针对的 Connection 对象。

说明

WillExecute 事件可能因 Connection.Execute、Command.Execute 或 Recordset.Open 而发生。pConnection 参数应当始终包含对 Connection 对象的有效引用。如果事件的原因是 Connection.Execute,则 pRecordset 和 pCommand 参数被设置为 Nothing。如果事件的原因是 Recordset.Open,则 pRecordset 参数将引用 Recordset 对象并且 pCommand 参数被设置为 Nothing。如果事件的原因是 Command.Execute,则 pCommand 参数将引用 Command 对象并且 pRecordset 参数被设置为 Nothing。