WillChangeField et FieldChangeComplete, événements (ADO)

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

Syntaxe

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

Paramètres

cFields
Entier Long indiquant le nombre d’objets Field dans Fields.

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

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

adStatus
Une valeur d’état EventStatusEnum.

Lorsque WillChangeField 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.

Quand FieldChangeComplete 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 WillChangeField retourne, définissez ce paramètre sur adStatusCancel pour demander l’annulation de l’opération en attente.

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

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

Notes

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

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