Freigeben über


WillChangeField- und FieldChangeComplete-Ereignisse (ADO)

Das WillChangeField--Ereignis wird aufgerufen, bevor ein ausstehender Vorgang den Wert eines oder mehrerer Field-Objekte im Recordset-ändert. Das FieldChangeComplete--Ereignis wird aufgerufen, nachdem der Wert eines oder mehrerer Field-Objekte geändert wurde.

Syntax

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

Parameter

cFields-
Ein Long, der die Anzahl der Field-Objekte in Fieldsangibt.

Felder
Für WillChangeField-ist der parameter Fields ein Array von Variants, das Field-Objekte mit den ursprünglichen Werten enthält. Für FieldChangeComplete-ist der parameter Fields ein Array Variants, das Field-Objekte mit den geänderten Werten enthält.

pError-
Ein Error-Objekt. Es beschreibt den Fehler, der aufgetreten ist, wenn der Wert von adStatus-adStatusErrorsOccurredist; andernfalls ist sie nicht festgelegt.

adStatus-
Ein EventStatusEnum Statuswert.

Wenn WillChangeField- aufgerufen wird, wird dieser Parameter auf adStatusOK- festgelegt, wenn der Vorgang, der das Ereignis verursacht hat, erfolgreich war. Es ist auf adStatusCantDeny festgelegt, wenn dieses Ereignis den Abbruch des ausstehenden Vorgangs nicht anfordern kann.

Wenn FieldChangeComplete- aufgerufen wird, wird dieser Parameter auf adStatusOK- festgelegt, wenn der Vorgang, der das Ereignis verursacht hat, erfolgreich war, oder adStatusErrorsOccurred, wenn der Vorgang fehlgeschlagen ist.

Bevor WillChangeField- zurückgegeben wird, legen Sie diesen Parameter auf adStatusCancel fest, um den Abbruch des ausstehenden Vorgangs anzufordern.

Bevor FieldChangeComplete- zurückgegeben wird, legen Sie diesen Parameter auf adStatusUnwantedEvent- fest, um nachfolgende Benachrichtigungen zu verhindern.

pRecordset-
Ein Recordset-Objekt. Das Recordset, für das dieses Ereignis aufgetreten ist.

Bemerkungen

Ein WillChangeField-- oder FieldChangeComplete--Ereignis kann auftreten, wenn die eigenschaft Value festgelegt und die Update-Methode mit Feld- und Wertarrayparametern aufgerufen wird.

Siehe auch

ADO-Ereignismodell (Beispiel) (VC++)
ADO-Ereignishandlerzusammenfassung