ADO Les événements WillChangeRecord et RecordChangeComplete
❮ Référence complète de l'objet Recordset
L'événement WillChangeRecord
L'événement WillChangeRecord est déclenché avant une ou plusieurs modifications d'enregistrement.
Remarque : Avant le retour de cet événement, définissez le paramètre d'état sur adStatusCancel pour annuler l'opération à l'origine de cet événement ou définissez-le sur adStatusUnwantedEvent pour empêcher les notifications ultérieures.
L'événement RecordChangeComplete
L'événement RecordChangeComplete est déclenché après la modification d'un ou plusieurs enregistrements.
Remarque : Avant le retour de cette méthode, définissez le paramètre d'état sur adStatusUnwantedEvent pour empêcher les notifications ultérieures.
Remarque : L'événement WillChangeRecord ou l'événement RecordChangeComplete peut se produire si vous modifiez un champ dans un enregistrement à l'aide de l'une des opérations Recordset suivantes : Update, Delete, CancelUpdate, AddNew, UpdateBatch et CancelBatch.
Syntaxe
WillChangeRecord reason,numrec,status,objRs
RecordChangeComplete reason,numrec,objErr,status,objRs
| Parameter | Description |
|---|---|
| reason | An EventReasonEnum value that specifies the reason for this event |
| numrec | Indicates the number of records affected |
| status | An EventStatusEnum value that indicates the status of the execution of the event |
| objErr | The name of an Error object that describes the error if status is set to adStatusErrorsOccurred, otherwise it is not set |
| objRs | The name of the Recordset Object that triggered this event |
Valeurs EventReasonEnum
| Constant | Value | Description |
|---|---|---|
| adRsnAddNew | 1 | An operation added a new record |
| adRsnDelete | 2 | An operation deleted a record |
| adRsnUpdate | 3 | An operation updated an existing record |
| adRsnUndoUpdate | 4 | An operation reversed the update of a record |
| adRsnUndoAddNew | 5 | An operation reversed the addition of a new record |
| adRsnUndoDelete | 6 | An operation reversed the deletion of a record |
| adRsnFirstChange | 11 | An operation made the first change to a record |
Valeurs EventStatusEnum
| Constant | Value | Description |
|---|---|---|
| adStatusOK | 1 | The operation that caused the event was successful |
| adStatusErrorsOccurred | 2 | The operation that caused the event failed |
| adStatusCantDeny | 3 | The operation that caused the event cannot be cancelled |
| adStatusCancel | 4 | The operation that caused the event is cancelled |
| adStatusUnwantedEvent | 5 | Prevents subsequent notifications before the event method has finished executing |
❮ Référence complète de l'objet Recordset