WillChangeRecordset et RecordsetChangeComplete, événements (ADO)

L’événement WillChangeRecordset est appelé avant qu’une opération en attente change l’objet Recordset. L’événement RecordsetChangeComplete est appelé après la modification du Recordset.

Syntaxe

  
WillChangeRecordset adReason, adStatus, pRecordset  
RecordsetChangeComplete adReason, pError, adStatus, pRecordset  

Paramètres

adReason
Valeur EventReasonEnum spécifiant la raison de cet événement. Sa valeur peut être adRsnRequery, adRsnResynch, adRsnClose, adRsnOpen.

adStatus
Valeur d’état EventStatusEnum.

Lorsque WillChangeRecordset est appelé, ce paramètre est défini sur adStatusOK si l’opération qui a provoqué le succès de l’événement. Il est défini sur 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 sur adStatusOK si l’opération qui a provoqué l’échec de l’événement, adStatusErrorsOccurred si l’opération a échoué ou adStatusCancel si l’opération associée à l’événement WillChangeRecordset précédemment accepté a été annulée.

Avant que WillChangeRecordset ne retourne, définissez ce paramètre sur adStatusCancel pour demander l’annulation de l’opération en attente ou définissez ce paramètre sur adStatusUnwantedEvent pour empêcher les notifications ultérieures.

Avant que WillChangeRecordset ou RecordsetChangeComplete retourne, définissez ce paramètre sur adStatusUnwantedEvent pour empêcher les notifications ultérieures.

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.

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

Notes

Un événement WillChangeRecordset ou RecordsetChangeComplete peut se produire en raison des méthodes Recordset Requery ou Open .

Si le fournisseur ne prend pas en charge les signets, une notification d’événement RecordsetChange se produit chaque fois que les nouvelles lignes sont récupérées du fournisseur. La fréquence de cet événement dépend de la propriété RecordsetCacheSize.

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