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