Поделиться через

WillChangeRecordset и RecordsetChangeComplete Events (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 или RecordsetChangeComplet e, задайте для этого параметра значение adStatusUnwantedEvent, чтобы предотвратить последующие уведомления.

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

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

Замечания

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

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

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

См. также

Пример модели событий ADO (VC++)
Сводка обработчика событий ADO