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。