Condividi tramite

Eventi WillChangeRecordset e RecordsetChangeComplete (ADO)

  • Articolo

L'evento WillChangeRecordset viene chiamato prima che un'operazione in sospeso modifichi l'oggetto Recordset. L'evento RecordsetChangeComplete viene chiamato dopo la modifica del Recordset.

Sintassi

  
WillChangeRecordset adReason, adStatus, pRecordset  
RecordsetChangeComplete adReason, pError, adStatus, pRecordset

Parametri

adReason
Valore EventReasonEnum che specifica il motivo di questo evento. Il valore può essere adRsnRequery, adRsnResynch, adRsnClose, adRsnOpen.

adStatus
Valore di stato EventStatusEnum.

Quando viene chiamato WillChangeRecordset, questo parametro viene impostato su adStatusOK se l'operazione che ha generato l'evento è riuscita. È impostato su adStatusCantDeny se questo evento non può richiedere l'annullamento dell'operazione in sospeso.

Quando viene chiamato RecordsetChangeComplete, questo parametro è impostato su adStatusOK se l'operazione che ha causato l'evento ha avuto esito positivo, adStatusErrorsOccurred se l'operazione ha avuto esito negativo o adStatusCancel se l'operazione associata all'evento WillChangeRecordset precedentemente accettato è stata annullata.

Prima di restituire WillChangeRecordset, impostare questo parametro su adStatusCancel per richiedere l'annullamento dell'operazione in sospeso oppure impostare questo parametro su adStatusUnwantedEvent per impedire le notifiche successive.

Prima di restituire WillChangeRecordset o RecordsetChangeComplete, impostare questo parametro su adStatusUnwantedEvent per impedire notifiche successive.

pError
Oggetto Error. Descrive l'errore che si è verificato se il valore di adStatus è adStatusErrorsOccurred. In caso contrario, non è impostato.

pRecordset
Oggetto Recordset. Oggetto Recordset per cui si è verificato questo evento.

Osservazioni:

Un evento WillChangeRecordset o RecordsetChangeComplete può verificarsi a causa dei metodi Recordset Requery o Open .

Se il provider non supporta i segnalibri, viene eseguita una notifica dell'evento RecordsetChange ogni volta che vengono recuperate nuove righe dal provider. La frequenza di questo evento dipende dalla proprietà RecordsetCacheSize.

È necessario impostare il parametro adStatus su adStatusUnwantedEvent per ogni possibile valore adReason per arrestare completamente la notifica degli eventi per qualsiasi evento che include un parametro adReason.

Vedi anche

Esempio di modello di eventi ADO (VC++)
Riepilogo dei gestori eventi ADO