Partager via

Événements WillChangeField et FieldChangeComplete (ADO)

  • Article

L’événement WillChangeField est appelé avant qu’une opération en attente change la valeur d’un ou plusieurs objets Field dans le jeu d’enregistrements . L’événement FieldChangeComplete est appelé après la modification de la valeur d’un ou plusieurs objets Field Field.

Syntaxe

  
WillChangeField cFields, Fields, adStatus, pRecordset  
FieldChangeComplete cFields, Fields, pError, adStatus, pRecordset

Paramètres

cFields
long qui indique le nombre d’objets Field dans Champs.

champs
Pour WillChangeField, le paramètre Fields est un tableau de Variants qui contient objets Field avec les valeurs d’origine. Pour FieldChangeComplete, le paramètre Fields est un tableau de Variants qui contient objets Field avec les valeurs modifiées.

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.

adStatus
Valeur d’état EventStatusEnum.

Quand WillChangeField 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 fieldChangeComplete est appelé, ce paramètre est défini sur adStatusOK si l’opération à l’origine de l’événement a réussi ou adStatusErrorsOccurred si l’opération a échoué.

Avant willChangeField retourne, définissez ce paramètre sur adStatusCancel pour demander l’annulation de l’opération en attente.

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

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

Remarques

Un événement WillChangeField ou FieldChangeComplete peut se produire lors de la définition de la propriété Value et de l’appel de la méthode Update avec des paramètres de champ et de tableau de valeurs.

Voir aussi

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