WillChangeRecordset 和 RecordsetChangeComplete 事件 (ADO)
在挂起的操作更改 Recordset之前调用 WillChangeRecordset 事件。 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 请求取消挂起的操作,或将此参数设置为 adStatusUnwantedEvent 以防止后续通知。
在 WillChangeRecordset 或 RecordsetChangeComplete 返回之前,请将此参数设置为 adStatusUnwantedEvent 以防止后续通知。
pError
错误 对象。 它描述 adStatus 的值 adStatusErrorsOccurred时发生的错误;否则,它未设置。
pRecordset
Recordset 对象。 发生此事件的 Recordset。
言论
WillChangeRecordset 或 RecordsetChangeComplete 事件发生可能是因为 RecordsetRequery 或 Open 方法。
如果提供程序不支持书签,则每次从提供程序检索新行时,都会发生 RecordsetChange 事件通知。 此事件的频率取决于 RecordsetCacheSize 属性。
必须为每个可能的 adReason 值将 adStatus 参数设置为 adStatusUnwantedEvent,才能针对包含 adReason 参数的任何事件完全停止事件通知。