Eventi WillChangeField e FieldChangeComplete (ADO)

  • Articolo

L'evento WillChangeField viene chiamato prima che un'operazione in sospeso modifichi il valore di uno o più oggetti Camponell'oggetto Recordset. L'evento FieldChangeComplete viene chiamato dopo la modifica del valore di uno o più oggetti Campo.

Sintassi

  
WillChangeField cFields, Fields, adStatus, pRecordset  
FieldChangeComplete cFields, Fields, pError, adStatus, pRecordset

Parametri

cFields
Valore Long che indica il numero di oggetti Campo in Campi.

Fields
Per WillChangeField, il parametro Campi è una matrice di Varianti che contiene oggetti Campo con i valori originali. Per FieldChangeComplete, il parametro Campi è una matrice di Varianti che contiene oggetti Campo con i valori modificati.

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

adStatus
Valore di stato EventStatusEnum.

Quando viene chiamato WillChangeField, questo parametro viene impostato su adStatusOK se l'operazione che ha causato l'evento ha avuto esito positivo. È impostato su adStatusCantDeny se questo evento non può richiedere l'annullamento dell'operazione in sospeso.

Quando viene chiamato FieldChangeComplete, questo parametro viene impostato su adStatusOK se l'operazione che ha causato l'evento è riuscita o su adStatusErrorsOccurred se l'operazione non è riuscita.

Prima che WillChangeField restituisca, impostare questo parametro su adStatusCancel per richiedere l'annullamento dell'operazione in sospeso.

Prima di restituire FieldChangeComplete, impostare questo parametro su adStatusUnwantedEvent per impedire le notifiche successive.

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

Osservazioni

È possibile che si verifichi un evento WillChangeField o FieldChangeComplete quando si imposta la proprietà Value e si chiama il metodo Update con parametri di matrice di campi e valori.

Vedere anche

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