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.