События WillChangeField и FieldChangeComplete (ADO)

Область применения: Access 2013, Office 2013

Событие WillChangeField вызывается до того, как ожидающая операция изменяет значение одного или нескольких объектов Field в наборе записей. Событие FieldChangeComplete вызывается после изменения значения одного или нескольких объектов Field .

Синтаксис

WillChangeFieldcFields, Fields, adStatus, pRecordset

FieldChangeCompletecFields, Fields, pError, adStatus, pRecordset

Параметры

Параметр	Описание
cFields	Значение Long, указывающее количество объектов Field в полях.
Fields	Для 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 . Набор записей, для которого произошло это событие.

Замечания

При установке свойства Value и вызове метода Update с параметрами массива полей и значений может возникнуть событие WillChangeField или FieldChangeComplete.