WillChangeRecordset et RecordsetChangeComplete Events (ADO)

L’événement WillChangeRecordset est appelé avant qu’une opération en attente change le jeu d’enregistrements . L’événement RecordsetChangeComplete est appelé une fois que le recordset de a changé.

Syntaxe

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

Paramètres

adReason
Valeur EventReasonEnum qui spécifie 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 à l’origine de l’événement a réussi. Elle est définie 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 à l’origine de l’événement a réussi, adStatusErrorsOccurred si l’opération a échoué ou adStatusCancel si l’opération associée à l’événement WillChangeRecordset a été annulée.

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

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

pError
Objet Error. Il décrit l’erreur qui s’est produite si la valeur de adStatus est adStatusErrorsOccurred; sinon, il n’est pas défini.

pRecordset
Objet Recordset. Le jeu d’enregistrements pour lequel cet événement s’est produit.

Remarques

Un événement WillChangeRecordset ou RecordsetChangeCom plete peut se produire en raison des méthodes RecordsetRequery 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 à partir 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 pour arrêter complètement la notification d’événement pour tout événement qui inclut un paramètre adReason.

Voir aussi

modèle d’événements ADO (VC++)
résumé du gestionnaire d’événements ADO