WillChangeRecordset 事件會在暫止作業變更 Recordset之前呼叫。 RecordsetChangeComplete 事件會在 Recordset 變更之後呼叫。
語法
WillChangeRecordset adReason, adStatus, pRecordset
RecordsetChangeComplete adReason, pError, adStatus, pRecordset
參數
adReason
EventReasonEnum 值,指定此事件的原因。 其值可以是 adRsnRequery、adRsnResynch、adRsnClose、adRsnOpen。
adStatus
EventStatusEnum 狀態值。
呼叫 WillChangeRecordset 時,如果造成事件的作業成功,此參數會設定為 adStatusOK。 如果此事件無法要求取消暫止作業,則會設定為 adStatusCantDeny。
呼叫 recordsetChangeComplete 時, RecordsetChangeComplete, 如果造成事件的作業成功,則此參數會設定為 adStatusOK,如果作業失敗,adStatusErrorsOccurred,或如果先前接受的作業與先前接受的 WillChangeRecordset 事件相關聯,adStatusCancel。
WillChangeRecordset 傳回之前,請將此參數設定為 adStatusCancel 要求取消暫止作業,或將此參數設定為 adStatusUnwantedEvent 以防止後續通知。
WillChangeRecordset 或 RecordsetChangeComplete 傳回之前,請將此參數設定為 adStatusUnwantedEvent 以防止後續通知。
pError
Error 物件。 它會描述如果 adStatus adStatusErrorsOccurred時所發生的錯誤;否則不會設定。
pRecordset
Recordset 物件。 發生此事件的 Recordset。
言論
WillChangeRecordset 或 RecordsetChangeComplete 事件可能會因為 RecordsetRequery 或 Open 方法而發生。
如果提供者不支援書籤,每次從提供者擷取新數據列時,就會發生 RecordsetChange 事件通知。 此事件的頻率取決於 RecordsetCacheSize 屬性。
您必須針對每個可能 adReason 值,將 adStatus 參數設定為 adStatusUnwantedEvent,以完全停止包含 adReason 參數的任何事件事件通知。