Validation.Errors Propriété attachée

see GetErrors

see GetErrors

see GetErrors

Remarques

L’application ne peut pas modifier le contenu de cette collection. Consultez la section Exemple pour obtenir un exemple d’utilisation de cette propriété jointe.

Le modèle de liaison de données WPF vous permet d’associer ValidationRules votre Binding objet. La validation se produit pendant le transfert de valeur source de la cible à liaison avant l’appel du convertisseur. Les éléments suivants décrivent le processus de validation :

1. Lorsqu’une valeur est transférée de la propriété cible à la propriété source, le moteur de liaison de données supprime d’abord les ValidationError éléments pouvant avoir été ajoutés à la System.Windows.Controls.Validation.Errors propriété jointe de l’élément lié. Il vérifie ensuite s’il existe des éléments personnalisés ValidationRuledéfinis pour cela Binding, auquel cas il appelle la Validate méthode sur chacun des ValidationRules jusqu’à ce qu’un d’entre eux rencontre une erreur ou jusqu’à ce que tous les passent.

2. Une fois qu’il existe une règle personnalisée qui ne passe pas, le moteur de liaison crée un ValidationError objet et l’ajoute à la System.Windows.Controls.Validation.Errors collection de l’élément lié. Lorsqu’il System.Windows.Controls.Validation.Errors n’est pas vide, la System.Windows.Controls.Validation.HasError propriété jointe de l’élément est définie sur true. En outre, si la NotifyOnValidationError propriété du fichier Binding est définie truesur , le moteur de liaison déclenche l’événement System.Windows.Controls.Validation.Error attaché sur l’élément.

3. Si toutes les règles passent, le moteur de liaison appelle ensuite le convertisseur, s’il en existe un.

4. Si le convertisseur réussit, le moteur de liaison appelle le setter de la propriété source.

5. Si la liaison est ExceptionValidationRule associée et qu’une exception est levée à l’étape 4, le moteur de liaison vérifie s’il existe un UpdateSourceExceptionFilter. Vous avez la possibilité d’utiliser le UpdateSourceExceptionFilter rappel pour fournir un gestionnaire personnalisé pour gérer les exceptions. Si un UpdateSourceExceptionFilter élément n’est pas spécifié sur le Binding, le moteur de liaison crée une ValidationError exception et l’ajoute à la System.Windows.Controls.Validation.Errors collection de l’élément lié.

Notez également qu’un transfert de valeur valide dans les deux sens (cible à source ou source à cible) efface la Validationpropriété jointe .Errors

Pour plus d’informations sur le comportement de cette propriété dans les MultiBinding scénarios, consultez ValidationError.

Pour plus d’informations, consultez « Validation des données » dans Vue d’ensemble de la liaison de données.

Utilisation du texte XAML

Voir les remarques. La Errors collection elle-même n’est pas définie par l’utilisateur, mais vous pouvez l’utiliser dans une définition de modèle de contrôle en XAML.

Informations sur les propriétés de dépendance