ExecuteComplete 事件 (ADO)
系統會在命令完成執行後呼叫 ExecuteComplete 事件。
語法
ExecuteComplete RecordsAffected, pError, adStatus, pCommand, pRecordset, pConnection
參數
RecordsAffected
Long 值,指出受命令影響的記錄數目。
pError
Error 物件。 該物件會描述如果 adStatus 值為 adStatusErrorsOccurred 時所發生的錯誤;否則不會設定。
adStatus
EventStatusEnum 狀態值。 呼叫此事件時,如果造成事件的作業成功,此參數會設定為 adStatusOK,如果作業失敗,則會設定為 adStatusErrorsOccurred。
在此事件傳回之前,請將此參數設定為 adStatusUnwantedEvent 以防止後續的通知。
pCommand
已執行的 Command 物件。 即使在呼叫 Connection.Execute 或 Recordset.Open 時未明確建立 Command,仍會包含 Command 物件,而在此情況下,會由 ADO 在內部建立 Command 物件。
pRecordset
執行命令後所產生的 Recordset 物件。 此 Recordset 可能是空的。 請絕對不要從這個事件處理常式內終結此 Recordset 物件。 這麼做會導致 ADO 嘗試存取已不存在的物件時發生存取違規。
pConnection
Connection 物件。 用來執行作業的連線。
備註
ExecuteComplete 事件的可能發生原因包括 Connection.Execute、Command.Execute、Recordset.Open、Recordset.Requery 或 Recordset.NextRecordset 方法。