WillChangeRecord- und RecordChangeComplete-Ereignisse (ADO)

Gilt für: Access 2013, Office 2013

Das WillChangeRecord -Ereignis wird aufgerufen, bevor ein oder mehrere Datensätze (Zeilen) im Recordset-Objekt geändert werden. Das RecordChangeComplete-Ereignis wird aufgerufen, nachdem ein oder mehrere Datensätze geändert wurden.

Syntax

WillChangeRecordadReason, cRecords, adStatus, pRecordset

RecordChangeCompleteadReason, cRecords, pError, adStatus, pRecordset

Parameter

Parameter	Beschreibung
adReason	Ein EventReasonEnum-Wert, der den Grund für dieses Ereignis angibt. Sein Wert kann adRsnAddNew, adRsnDelete, adRsnUpdate, adRsnUndoUpdate, adRsnUndoAddNew, adRsnUndoDelete oder adRsnFirstChange sein.
cRecords	Ein Long -Wert, der die Anzahl sich ändernder (betroffener) Datensätze angibt.
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 WillChangeRecord 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 RecordChangeComplete 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. Before WillChangeRecord returns, set this parameter to adStatusCancel to request cancellation of the operation that caused this event or set this parameter to adStatusUnwantedEvent to prevent subsequent notications. Legen Sie diesen Parameter vor der Rückgabe von RecordChangeComplete auf AdStatusUnwantedEvent fest, um nachfolgende Benachrichtigungen zu verhindern.
pRecordset	Ein Recordset-Objekt. Das Recordset-Objekt, für das dieses Ereignis eingetreten ist.

Hinweise

Ein WillChangeRecord - oder ein RecordChangeComplete -Ereignis kann aufgrund der folgenden Recordset -Vorgänge für das erste geänderte Feld einer Zeile eintreten: Update, Delete, CancelUpdate, AddNew, UpdateBatch und CancelBatch. Mit dem Recordset -Wert CursorType wird bestimmt, welche Vorgänge für das Eintreten der Ereignisse verantwortlich sind.

Während des WillChangeRecord -Ereignisses wird die Filter-Eigenschaft des Recordset -Objekts auf adFilterAffectedRecords festgelegt. Sie können diese Eigenschaft nicht ändern, während das Ereignis verarbeitet wird.

You must set the adStatus parameter to adStatusUnwantedEvent for each possible adReason value in order to completely stop event noticiation for any event that includes an adReason parameter.