WillChangeField 和 FieldChangeComplete 事件 (ADO)

在挂起的操作更改记录集中一个或多个 Field 对象的值之前调用 WillChangeField 事件。 FieldChangeComplete 事件在一个或多个 Field 对象的值发生更改后调用。

语法

  
WillChangeField cFields, Fields, adStatus, pRecordset  
FieldChangeComplete cFields, Fields, pError, adStatus, pRecordset  

参数

cFields
Long,指示 Fields 中的 Field 对象的数量。

字段
对于 WillChangeField ,Fields 参数是一个 Variants 数组,其中包含具有原始值的 Field 对象。 对于 FieldChangeComplete,Fields 参数是一个 Variants 数组,其中包含具有更改值的 Field 对象。

pError
一个 Error 对象。 它描述了在 adStatus 的值为 adStatusErrorsOccurred 时发生的错误;否则不设置此参数。

adStatus
EventStatusEnum 状态值。

调用 WillChangeField 时,如果导致事件的操作成功,则此参数设置为 adStatusOK。 如果此事件无法请求取消挂起的操作,则设置为 adStatusCantDeny。

调用 FieldChangeComplete 事件时,如果导致事件的操作成功,则此参数设置为 adStatusOK;如果操作失败,则设置为 adStatusErrorsOccurred。

在 WillChangeField 返回之前,将此参数设置为 adStatusCancel 以请求取消挂起的操作。

在 FieldChangeComplete 返回之前,请将此参数设置为 adStatusUnwantedEvent 以阻止后续通知。

pRecordset
一个 Recordset 对象。 发生此事件的 Recordset。

备注

设置 Value 属性并使用字段和值数组参数调用 Update 方法时,可能会发生 WillChangeField 或 FieldChangeComplete 事件。

另请参阅

ADO 事件模型示例 (VC++)
ADO 事件处理程序摘要