Événements WillChangeRecordset et RecordsetChangeComplete (ADO)
S’applique à : Access 2013, Office 2013
L'événement WillChangeRecordset est appelé avant qu'une opération en attente modifie l'objet Recordset. À l’inverse, l’événement RecordsetChangeComplete est appelé après cette modification de l’objet Recordset.
Syntaxe
WillChangeRecordsetadReason, adStatus, pRecordset
RecordsetChangeCompleteadReason, pError, adStatus, pRecordset
Paramètres
| Paramètre | Description |
|---|---|
| adReason | Valeur EventReasonEnum indiquant la raison de cet événement. Les valeurs possibles sont adRsnRequery, adRsnResynch, adRsnClose et adRsnOpen. |
| adStatus |
EventStatusEnum. Lorsque WillChangeRecordset 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 RecordsetChangeComplete 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, à adStatusErrorsOccurred si cette dernière a échoué ou encore à adStatusCancel si l'opération associée à l'événement WillChangeRecordset précédemment accepté a été annulée Avant que WillChangeRecordset soit retourné, définissez ce paramètre à adStatusCancel pour demander l'annulation de l'opération en attente ou à adStatusUnwantedEvent pour éviter toute notification ultérieure. Avant que WillChangeRecordset ou que RecordsetChangeComplete soit retourné, définissez ce paramètre à adStatusUnwantedEvent pour éviter toute notification ultérieure. |
| pError | Objet Error. Dans le cas contraire, il n'est pas défini. |
| pRecordset | A Recordset object. The Recordset for which this event occurred. |
Remarques
Il se peut qu'un événement WillChangeRecordset ou RecordsetChangeComplete se produise suite à l'utilisation de la méthode Requery ou Open sur l'objet Recordset.
Si le fournisseur ne prend pas en charge les signets, une notification d'événement RecordsetChange est générée chaque fois que des nouvelles lignes sont extraites du fournisseur. La fréquence de cet événement dépend de la propriété RecordsetCacheSize.
Vous devez affecter au paramètre adStatus la valeur adStatusUnwantedEvent pour chaque valeur possible du paramètre adReason afin d'empêcher définitivement les notifications des événements comprenant un paramètre adReason.