Partager via

WillChangeRecord et RecordChangeComplete, événements (ADO)

  • Article

L’événement WillChangeRecord est appelé avant le changement d’un ou plusieurs enregistrements (lignes) dans l’objet Recordset. L’événement RecordChangeComplete est appelé après le changement d’un ou plusieurs enregistrements.

Syntaxe

  
WillChangeRecord adReason, cRecords, adStatus, pRecordset  
RecordChangeCompleteadReason, cRecords, pError, adStatus, pRecordset

Paramètres

adReason
Valeur EventReasonEnum spécifiant la raison de cet événement. Cette valeur peut être adRsnAddNew, adRsnDelete, adRsnUpdate, adRsnUndoUpdate, adRsnUndoAddNew, adRsnUndoDelete ou adRsnFirstChange.

cRecords
Valeur Long indiquant le nombre d’enregistrements qui changent (affectés).

pError
Un objet Error. Il décrit l’erreur qui s’est produite si la valeur adStatus est adStatusErrorsOccurred. Autrement, il n’est pas défini.

adStatus
Valeur d’état EventStatusEnum.

Quand l’événement WillChangeRecord est appelé, ce paramètre est défini sur adStatusOK si l’opération qui a provoqué l’événement a réussi. Il est défini sur adStatusCantDeny si cet événement ne peut pas demander l’annulation de l’opération en attente.

Quand l’événement RecordChangeComplete est appelé, ce paramètre est défini sur adStatusOK si l’opération qui a provoqué l’événement a réussi, ou sur adStatusErrorsOccurred si l’opération a échoué.

Avant que l’événement WillChangeRecord retourne un résultat, définissez ce paramètre sur adStatusCancel pour demander l’annulation de l’opération qui a provoqué cet événement, ou définissez ce paramètre sur adStatusUnwantedEvent pour empêcher les notifications ultérieures.

Avant que l’événement RecordChangeComplete retourne un résultat, définissez ce paramètre sur adStatusUnwantedEvent pour empêcher les notifications suivantes.

pRecordset
Un objet Recordset. Objet Recordset pour lequel cet événement s’est produit.

Notes

Un événement WillChangeRecord ou RecordChangeComplete peut se produire pour le premier champ modifié dans une ligne en raison des opérations d’objet Recordset suivantes : Update, Delete, CancelUpdate, AddNew, UpdateBatch et CancelBatch. La valeur du jeu d’enregistrements CursorType détermine les opérations qui provoquent l’exécution des événements.

Pendant l’événement WillChangeRecord, la propriété Recordset Filter est définie sur adFilterAffectedRecords. Vous ne pouvez pas modifier cette propriété pendant le traitement de l’événement.

Vous devez définir le paramètre adStatus sur adStatusUnwantedEvent pour chaque valeur adReason possible afin d’arrêter complètement les notifications d’événements pour tout événement qui inclut un paramètre adReason.

Voir aussi

Exemple de modèle d’événements ADO (VC ++)
Présentation rapide du gestionnaire d’événements ADO