Événements WillChangeField et FieldChangeComplete (ADO)
S’applique à : Access 2013, Office 2013
L'événement WillChangeField est appelé avant qu'une opération en attente modifie la valeur d'objets Field dans l'objet Recordset. Quant à l’événement FieldChangeComplete, il est appelé après la modification de la valeur d’un ou plusieurs objets Field.
Syntaxe
WillChangeFieldcFields, Fields, adStatus, pRecordset
FieldChangeCompletecFields, Fields, pError, adStatus, pRecordset
Paramètres
| Paramètre | Description |
|---|---|
| cFields | Valeur de type Long indiquant le nombre d'objets Field inclus dans Fields. |
| Fields | Dans le cas de WillChangeField, le paramètre Fields correspond à un tableau de valeurs de type Variant qui contient des objets Field avec les valeurs d'origine. En ce qui concerne FieldChangeComplete, le paramètre Fields correspond à un tableau de valeurs de type Variant qui contient des objets Field avec les valeurs modifiées. |
| Perror | Objet Error. Dans le cas contraire, il n'est pas défini. |
| adStatus |
EventStatusEnum. Lorsque WillChangeField 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 FieldChangeComplete est appelé, ce paramètre a la valeur adStatusOK si l'opération à l'origine de l'événement s'est déroulée correctement ou adStatusErrorsOccurred si cette dernière a échoué. Avant que WillChangeField ne soit retourné, affectez la valeur adStatusCancel à ce paramètre pour demander l'annulation de l'opération en attente. Avant que FieldChangeComplete ne soit retourné, affectez la valeur adStatusUnwantedEvent à ce paramètre afin d'empêcher toute notification ultérieure. |
| pRecordset | A Recordset object. The Recordset for which this event occurred. |
Remarques
Un événement WillChangeField ou FieldChangeComplete est parfois généré lorsque vous définissez la propriété Value et que vous appelez la méthode Update à l’aide des paramètres de tableau de champs et de valeurs.