WillChangeRecord 和 RecordChangeComplete (RecordsetEvent) 方法

WillChangeRecord 方法在 Recordset 中的一个或多个记录(行)更改之前调用。RecordChangeComplete 方法在一个或多个记录更改之后调用。

语法

WillChangeRecord adReason, cRecords, adStatus, pRecordset

RecordChangeComplete adReason, cRecords, pError, adStatus, pRecordset

参数

adReason   EventReasonEnum 值,指定该事件的原因。它的值可以是 adRsnAddNewadRsnDeleteadRsnUpdateadRsnUndoUpdateadRsnUndoAddNewadRsnUndoDeleteadRsnFirstChange

cRecords   长整型,更改(影响)的记录数目。

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

adStatus   EventStatusEnum 状态值。

当调用 WillChangeRecord 时,如果引发事件的操作成功,该参数设置为 adStatusOK。如果该方法无法请求取消挂起的操作,则设置为 adStatusCantDeny

当调用 RecordChangeComplete 时,如果引发事件的操作成功,则该参数设置为 adStatusOK。如果操作失败,则设置为 adStatusErrorsOccurred

WillChangeRecord 返回前,将该参数设置为 adStatusCancel 可请求取消引发该事件的操作。

RecordChangeComplete 返回前,将该参数设置为 adStatusUnwantedEvent 可防止后续的通知。

pRecordset   Recordset 对象,发生该事件所针对的 Recordset

说明

WillChangeRecordRecordChangeComplete 事件可因下列 Recordset 操作并针对行中第一个更改的字段发生:UpdateDeleteCancelUpdateAddNewUpdateBatchCancelBatchRecordset CursorType 的值决定了是哪一个操作导致事件发生。

WillChangeRecord 事件期间,Recordset Filter 属性设置为 adFilterAffectedRecords。在处理事件时更改该属性是不合法的。

www.holmesian.org