Événements WillChangeRecord et RecordChangeComplete (ADO)

S’applique à : Access 2013, Office 2013

L'événement WillChangeRecord est appelé avant qu'un ou plusieurs enregistrements (lignes) de l'objet Recordset soient modifiés. À l’inverse, l’événement RecordChangeComplete est appelé après la modification d’enregistrements.

Syntaxe

WillChangeRecordadReason, cRecords, adStatus, pRecordset

RecordChangeCompleteadReason, cRecords, pError, adStatus, pRecordset

Paramètres

Paramètre	Description
adReason	Valeur EventReasonEnum indiquant la raison de cet événement. Les valeurs possibles sont adRsnAddNew, adRsnDelete, adRsnUpdate, adRsnUndoUpdate, adRsnUndoAddNew, adRsnUndoDelete et adRsnFirstChange.
cRecords	Valeur de type Long indiquant le nombre d'enregistrements en cours de modification (c'est-à-dire affectés par l'opération).
pError	Objet Error. Dans le cas contraire, il n'est pas défini.
adStatus	EventStatusEnum. Lorsque WillChangerecord est appelé, ce paramètre est défini à adStatusOK si l'opération à l'origine de l'événement s'est déroulée correctement. Il est défini à adStatusCantDeny si cet événement ne peut pas demander l'annulation de l'opération en attente. Lorsque RecordChangeComplete est appelé, ce paramètre a la valeur adStatusOK si l'opération à l'origine de l'événement s'est déroulée correctement ou adStatusErrorsOccurred si cette dernière a échoué. Avant que WillChangeRecord soit retourné, définissez ce paramètre à adStatusCancel pour demander l'annulation de l'opération à l'origine de l'événement ou à adStatusUnwantedEvent pour éviter toute notification ultérieure. Avant que RecordChangeComplete soit retourné, définissez ce paramètre à adStatusUnwantedEvent pour éviter toute notification ultérieure.
pRecordset	A Recordset object. The Recordset for which this event occurred.

Remarques

Il se peut qu'un événement WillChangeRecord ou RecordChangeComplete se produise pour le premier champ modifié dans une ligne lorsque les opérations suivantes sont effectuées sur l'objet Recordset: Update, Delete, CancelUpdate, AddNew, UpdateBatch et CancelBatch. La valeur de la propriété CursorType de l'objet Recordset détermine les opérations qui déclenchent les événements.

Dans le cas de l'événement WillChangeRecord, la propriété Filter de l'objet Recordset est définie à adFilterAffectedRecords. Sa valeur n'est pas modifiable lorsque l'événement est en cours de traitement.

Vous devez affecter la valeur adStatusUnwantedEvent au paramètre adStatus pour chaque valeur possible du paramètre adReason afin d'empêcher définitivement les notifications des événements comprenant un paramètre adReason.