События WillChangeRecordset и RecordsetChangeComplete (ADO)

Область применения: Access 2013, Office 2013

Событие WillChangeRecordset вызывается до того, как ожидающая операция изменяет набор записей. Событие RecordsetChangeComplete вызывается после изменения набора записей .

Синтаксис

WillChangeRecordsetadReason, adStatus, pRecordset

RecordsetChangeCompleteadReason, 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 Может произойти из-за методов Requeryrecordset или Open.

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

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