WillChangeField- und FieldChangeComplete-Ereignisse (ADO)

Gilt für: Access 2013, Office 2013

Das WillChangeField -Ereignis wird aufgerufen, bevor der Wert eines oder mehrerer Field-Objekte im Recordset-Objekt durch einen ausstehenden Vorgang geändert wird. Das FieldChangeComplete-Ereignis wird aufgerufen, nachdem der Wert eines oder mehrerer Field-Objekte geändert wurde.

Syntax

WillChangeFieldcFields, Fields, adStatus, pRecordset

FieldChangeCompletecFields, Fields, pError, adStatus, pRecordset

Parameter

Parameter Beschreibung
cFields Ein Long-Wert, der die Anzahl der Field-Objekte von Fields angibt.
Fields Für WillChangeField ist der Fields-Parameter ein Array von Variant-Werten, die Field-Objekte mit den ursprünglichen Werten enthalten.

Für FieldChangeComplete ist der Fields-Parameter ein Array von Variant-Werten, die Field-Objekte mit geänderten Werten enthalten.
Perror Ein Error-Objekt. Es beschreibt den Fehler, der auftritt, wenn der Wert von adStatus auf adStatusErrorsOccurred festgelegt wird; andernfalls wird er nicht festgelegt.
adStatus EventStatusEnum. Wird WillChangeField aufgerufen, wird dieser Parameter auf adStatusOK festgelegt, wenn der das Ereignis verursachende Vorgang erfolgreich war. Der Parameter wird auf adStatusCantDeny festgelegt, wenn dieses Ereignis den Abbruch des ausstehenden Vorgangs nicht anfordern kann.

Wird FieldChangeComplete aufgerufen, wird dieser Parameter auf adStatusOK festgelegt, wenn der das Ereignis verursachende Vorgang erfolgreich war. Er wird auf adStatusErrorsOccurred festgelegt, wenn der Vorgang fehlgeschlagen ist.

Legen Sie diesen Parameter vor der Rückgabe von WillChangeField auf AdStatusCancel fest, um den Abbruch des ausstehenden Vorgangs anzufordern.

Legen Sie diesen Parameter vor der Rückgabe von FieldChangeComplete auf AdStatusUnwantedEvent fest, um nachfolgende Benachrichtigungen zu verhindern.
pRecordset Ein Recordset-Objekt. Das Recordset-Objekt, für das dieses Ereignis eingetreten ist.

Hinweise

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