Validation.Errors Propriété attachée

Définition

Obtient la collection de tous les objets ValidationError actifs sur l’élément lié.

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 de l’associer ValidationRules à votre Binding objet. La validation se produit lors du transfert de valeur de la cible à la source de liaison avant l’appel du convertisseur. Ce qui suit décrit le processus de validation :

  1. Lorsqu’une valeur est transférée de la propriété cible vers la propriété source, le moteur de liaison de données supprime tout ce ValidationError qui a pu être ajouté à la System.Windows.Controls.Validation.Errors propriété jointe de l’élément lié. Il vérifie ensuite s’il existe des s personnalisés ValidationRuledéfinis pour cela , auquel cas il appelle la Validate méthode sur chacun des s jusqu’à ce que l’un ValidationRuled’eux rencontre une erreur ou jusqu’à ce que Bindingtous les s passent.

  2. Une fois qu’une règle personnalisée n’est pas passée, le moteur de liaison crée un ValidationError objet et l’ajoute à la System.Windows.Controls.Validation.Errors collection de l’élément lié. Lorsque 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 propriété NotifyOnValidationError du Binding est définie sur true, 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 sont passées, le moteur de liaison appelle le convertisseur, le cas échéant.

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

  5. Si la liaison est associée à un ExceptionValidationRule 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 la gestion des exceptions. Si un UpdateSourceExceptionFilter n’est pas spécifié sur , Bindingle moteur de liaison crée un ValidationError avec l’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 (de cible à source ou de source à cible) efface le Validation.Errorspropriété jointe.

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

Consultez la section Notes. La Errors collection elle-même n’est pas paramétrable 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

Champ Identificateur ErrorsProperty
Propriétés de métadonnées définies sur true IsNotDataBindable

S’applique à