События WillChangeRecordset и RecordsetChangeComplete (ADO)
Событие WillChangeRecordset вызывается до того, как ожидающая операция изменяет набор записей. Событие RecordsetChangeComplete вызывается после изменения набора записей .
Синтаксис
WillChangeRecordset adReason, adStatus, pRecordset
RecordsetChangeComplete adReason, pError, adStatus, pRecordset
Параметры
adReason
Значение EventReasonEnum , указывающее причину этого события. Его значение может быть adRsnRequery, adRsnResynch, adRsnClose, adRsnOpen.
adStatus
Значение состояния EventStatusEnum .
При вызове Метода WillChangeRecordset этому параметру присваивается значение adStatusOK , если операция, вызвавшей событие, была успешной. Для этого события задано значение adStatusCantDeny , если это событие не может запросить отмену ожидающей операции.
При вызове RecordsetChangeCompleteComplete этому параметру присваивается значение adStatusOK , если операция, вызвавшей событие, была успешной, adStatusErrorsOccurred , если операция завершилась сбоем, или adStatusCancel , если операция, связанная с ранее принятым событием WillChangeRecordset, была отменена .
Перед возвратом WillChangeRecordset задайте для этого параметра значение adStatusCancel , чтобы запросить отмену ожидающей операции, или задайте для этого параметра значение adStatusUnwantedEvent, чтобы предотвратить последующие уведомления.
Перед возвратом WillChangeRecordset или RecordsetChangeComplete задайте для этого параметра значение adStatusUnwantedEvent , чтобы предотвратить последующие уведомления.
pError
Объект Error . Он описывает ошибку, которая произошла, если значение adStatus имеет значение adStatusErrorsOccurred; в противном случае он не задан.
pRecordset
Объект Recordset . Набор записей, для которого произошло это событие.
Комментарии
Событие WillChangeRecordset или RecordsetChangeComplete Может возникнуть из-за методов Requeryrecordset или Open.
Если поставщик не поддерживает закладки, при каждом получении от поставщика новых строк происходит уведомление о событии RecordsetChange . Частота этого события зависит от свойства RecordsetCacheSize .
Для параметра adStatus необходимо задать значение adStatusUnwantedEvent для каждого возможного значения adReason , чтобы полностью остановить уведомление о событии для любого события, включающего параметр adReason .
См. также:
Пример модели событий ADO (Visual C ++)
Общие сведения об обработчике событий ADO
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по