WillChangeRecord 和 RecordChangeComplete (ConnectionEvent) 方法 (ADO)

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 对象,发生该事件所针对的记录集。

说明

WillChangeRecordRecordChangeComplete 事件可因下列 Recordset 操作而发生:UpdateDeleteCancelUpdateAddNewUpdateBatchCancelBatch

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