ValidationError Classe

Définition

public ref class ValidationError

public class ValidationError

type ValidationError = class

Public Class ValidationError

Héritage

Object

ValidationError

Exemples

L’exemple suivant montre un déclencheur de style qui crée un ToolTip message d’erreur de validation. La Validation.Errors propriété jointe retourne une collection d’objets ValidationError sur l’élément lié.

<Style x:Key="textStyleTextBox" TargetType="TextBox">
  <Setter Property="Foreground" Value="#333333" />
  <Setter Property="MaxLength" Value="40" />
  <Setter Property="Width" Value="392" />
  <Style.Triggers>
    <Trigger Property="Validation.HasError" Value="true">
      <Setter Property="ToolTip"
        Value="{Binding RelativeSource={RelativeSource Self},
                        Path=(Validation.Errors)[0].ErrorContent}"/>
    </Trigger>
  </Style.Triggers>
</Style>

Remarques

Le modèle de liaison de données WPF vous permet d’associer des règles de validation à votre Binding objet. La validation se produit pendant le transfert de valeur cible à source avant l’appel du convertisseur. Le code suivant décrit 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 susceptibles d’avoir été ajoutés à la Validation.Errors propriété jointe de l’élément lié. Il vérifie ensuite si des règles de validation personnalisées sont définies pour cela Binding, auquel cas elle appelle la Validate méthode sur chacune ValidationRule jusqu’à ce qu’une d’elles échoue 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 Validation.Errors collection de l’élément lié. Lorsqu’il Validation.Errors n’est pas vide, la 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 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 3 ou 4, le moteur de liaison vérifie s’il existe un UpdateSourceExceptionFilter. Vous pouvez 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 Validation.Errors collection de l’élément lié.

Un transfert de valeur valide dans les deux sens (cible vers la source ou la source vers la cible) efface la Validation.Errors propriété jointe.

Voir aussi

• DataErrorValidationRule
• ValidationRule
• MarkInvalid(BindingExpressionBase, ValidationError)