События 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