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

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

Синтаксис

  
WillChangeField cFields, Fields, adStatus, pRecordset  
FieldChangeComplete cFields, 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 . Набор записей, для которого произошло это событие.

Комментарии

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

См. также:

Пример модели событий ADO (Visual C ++)
Общие сведения об обработчике событий ADO