WillChangeRecordset 和 RecordsetChangeComplete (RecordsetEvent) 事件


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 时，如果引发事件的操作成功，则该参数设置为 adStatusOK；如果操作失败，则设置为 adStatusErrorsOccurred；如果与以前接受的 WillChangeRecordset 事件关联的操作已经取消，则设置为 adStatusCancel。

在 WillChangeRecordset 返回前，将该参数设置为 adStatusCancel 以请求取消挂起操作。

在 WillChangeRecordset 或 RecordsetChangeComplete 返回前，将该参数设置为 adStatusUnwantedEvent 可避免后续的通知。

pError Error 对象，说明当 adStatus 值为 adStatusErrorsOccurred 时所发生的错误，否则将不对它进行设置。

pRecordset Recordset 对象，发生该事件所针对的记录集。

说明

WillChangeRecordset 或 RecordsetChangeComplete 事件可因下列 Recordset 操作而发生：Requery 和 Open。

如果提供者不支持书签，则每次从提供者处检索新行时发生 RecordsetChange 事件通知。该事件的频率取决于 RecordsetCacheSize 属性。