Condividi tramite

Eventi WillChangeRecordset e RecordsetChangeComplete (ADO)

  • Articolo

L'evento WillChangeRecordset viene chiamato prima che un'operazione in sospeso cambi 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 dell'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 causato 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 è riuscita, adStatusErrorsOccurred se l'operazione non è riuscita 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 o impostare questo parametro su adStatusUnwantedEvent per impedire le notifiche successive.

Prima di WillChangeRecordset o restituisce RecordsetChangeComplete, impostare questo parametro su adStatusUnwantedEvent per impedire le 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 . recordset per cui si è verificato questo evento.

Osservazioni

È possibile che si verifichi un evento WillChangeRecordset o RecordsetChang eCompleteComplete a causa dei metodi Recordset Requery o Open.

Se il provider non supporta i segnalibri, viene generata una RecordsetChange notifica degli eventi 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 .

Vedere anche

esempio di modello di eventi ADO (VC++)
riepilogo del gestore eventi ADO