WillChangeField- und FieldChangeComplete-Ereignis (ADO)

  • Artikel

Das WillChangeField-Ereignis wird aufgerufen, bevor ein ausstehender Vorgang den Wert von mindestens einem Field-Objekt im Recordset ändert. Das FieldChangeComplete-Ereignis wird aufgerufen, nachdem sich der Wert von mindestens einem Field-Objekt geändert hat.

Syntax

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

Parameter

cFields
Ein Wert vom Typ Long, der die Anzahl der Field-Objekte in Fields angibt.

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

pError
Ein Error-Objekt. Dieser Parameter enthält eine Beschreibung des aufgetretenen Fehlers, wenn adStatus den Wert adStatusErrorsOccurred aufweist. Andernfalls ist er 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 wird auf adStatusCantDeny festgelegt, wenn dieses Ereignis keinen Abbruch des ausstehenden Vorgangs anfordern kann.

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

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

Bevor FieldChangeComplete zurückgegeben wird, legen Sie den Parameter auf adStatusUnwantedEvent, um weitere 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 Value-Eigenschaft festgelegt und die Update-Methode mit Feld- und Wertarrayparametern aufgerufen wird.

Weitere Informationen

ADO-Ereignismodell – Beispiel (VC++)
ADO-Ereignishandler – Übersicht