WillExecute 事件 (ADO)

在挂起的命令在连接上执行之前调用 WillExecute 事件。

语法

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

参数


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

CursorType
CursorTypeEnum,其中包含将打开的 Recordset 的游标类型。 使用此参数,可以在 RecordsetOpen 方法(ADO Recordset) 操作期间将游标更改为任意类型。 对于任何其他操作,将忽略 CursorType

LockType
LockTypeEnum,其中包含将打开的 Recordset 的锁类型。 使用此参数,可以在 RecordsetOpen 操作期间将锁更改为任何类型。 对于任何其他操作,将忽略 LockType

选项
Long 值,该值指示可用于执行命令或打开 Recordset的选项。

adStatus
EventStatusEnum 状态值,在调用此事件时,可能会 adStatusCantDenyadStatusOK。 如果 adStatusCantDeny,则此事件可能不会请求取消挂起的操作。

pCommand
命令对象(ADO) 应用此事件通知的对象。

pRecordset
Recordset 对象(ADO) 应用此事件通知的对象。

pConnection
此事件通知适用的 连接对象(ADO) 对象。

言论

WillExecute 事件可能因连接而发生。 Execute 方法(ADO 连接)Execute 方法(ADO 命令)Open 方法(ADO Recordset) 方法。pConnection 参数应始终包含对 Connection 对象的有效引用。 如果事件由于 Connection.ExecutepRecordsetpCommand 参数设置为 Nothing。 如果事件由于 Recordset.Open,则 pRecordset 参数将引用 Recordset 对象,并将 pCommand 参数设置为 Nothing。 如果事件由于 Command.ExecutepCommand 参数将引用 Command 对象,pRecordset 参数设置为 Nothing

WillExecute 允许检查和修改挂起的执行参数。 此事件可能会返回请求,请求取消挂起的命令。

注意

如果 Command 的原始源是由 CommandStream 属性 (ADO) 属性指定的流,请将新字符串分配给 WillExecuteSource 参数更改 命令的源。 CommandStream 属性将被清除,CommandText 属性 (ADO) 属性将使用新源更新。 CommandStream 指定的原始流将被释放,无法访问。

如果新源字符串的方言不同于 方言属性 属性的原始设置(对应于 CommandStream),则必须通过设置 pCommand引用的命令对象的 方言 属性来指定正确的方言。

另请参阅

ADO 事件模型示例 (VC++)
ADO 事件处理程序摘要
连接对象 (ADO)