Data.DB.TField.OnValidate
Delphi
property OnValidate: TFieldNotifyEvent read FOnValidate write FOnValidate;
C++
__property TFieldNotifyEvent OnValidate = {read=FOnValidate, write=FOnValidate};
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| event | published | Data.DB.pas Data.DB.hpp |
Data.DB | TField |
Description
Se produit juste avant l'écriture des données dans le tampon d'enregistrement.
Un gestionnaire d'événements OnValidate permet de valider les modifications apportées aux données du champ, juste avant qu'elles ne soient écrites dans le tampon de l'enregistrement en cours. La propriété EditMask permet la validation des données saisies, caractère par caractère. OnValidate permet à une application de valider globalement les données.
Quand la valeur d'un composant champ est affectée par du code, la validation par EditMask n'est pas effectuée puisqu'il n'y a pas de contrôle orienté données pour vérifier le respect du masque. OnValidate permet à une application de valider ces données avant qu'elles ne soient expédiées à la table de la base de données.
Pour refuser la valeur en cours du champ dans le gestionnaire d'événements OnValidate, déclenchez une exception.
Lors de l'écriture de la valeur d'un champ dans le tampon de l'enregistrement en cours, la séquence suivante a lieu :
1. Le gestionnaire d'événements OnValidate est appelé pour valider les données.
2. Si le gestionnaire d'événements OnValidate accepte la valeur en cours (Value), les données sont écrites dans le tampon d'enregistrement.
3. Si l'écriture des données ne déclenche pas d'exception, le gestionnaire d'événements OnChange est appelé pour permettre de répondre aux modifications.
OnValidate est un gestionnaire d'événements du type Data.DB.TFieldNotifyEvent.