События 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 , если это событие не может запросить отмену ожидающей операции.

При вызове RecordsetChangeComplete этот параметр имеет значение adStatusOK, если операция, вызвавшей событие успешно, adStatusErrorsOccurred, если операция завершилась сбоем, или adStatusCancel, если операция, связанная с ранее принятым событием WillChangeRecordset, была отменена.

Перед возвратом WillChangeRecordset задайте для этого параметра значение adStatusCancel , чтобы запросить отмену ожидающей операции или задать этот параметр adStatusUnwantedEvent, чтобы предотвратить последующие уведомления.

Перед возвратом WillChangeRecordset или RecordsetChangeComplete задайте для этого параметра значение adStatusUnwantedEvent , чтобы предотвратить последующие уведомления.

pError
Объект Error . В нем описывается ошибка, которая произошла, если значение adStatus является adStatusErrorsOccurred; в противном случае оно не задано.

pRecordset
Объект Recordset. Набор записей, для которого произошло это событие.

Замечания

Событие WillChangeRecordset или RecordsetChangeComplete может возникать из-за методов Requery или Open набора записей.

Если поставщик не поддерживает закладки, уведомление о событии RecordsetChange возникает каждый раз, когда новые строки извлекаются из поставщика. Частота этого события зависит от свойства RecordsetCacheSize .

Для каждого возможного значения adReason необходимо задать параметр adStatusUnwantedEvent, чтобы полностью остановить уведомление о событиях для любого события, включающего параметр adReason.

См. также

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