Comment : implémenter la validation de la liaison

  • Article

Cet exemple montre comment utiliser un ErrorTemplate déclencheur de style et un déclencheur de style pour fournir des commentaires visuels pour informer l’utilisateur lorsqu’une valeur non valide est entrée, en fonction d’une règle de validation personnalisée.

Exemple

Le contenu texte de l’exemple TextBox suivant est lié à la Age propriété (de type int) d’un objet source de liaison nommé ods. La liaison est configurée pour utiliser une règle de validation nommée AgeRangeRule afin que si l’utilisateur entre des caractères non numériques ou une valeur inférieure à 21 ou supérieure à 130, un point d’exclamation rouge apparaisse en regard de la zone de texte et une info-bulle contenant le message d’erreur s’affiche lorsque l’utilisateur déplace la souris sur la zone de texte.

<TextBox Name="textBox1" Width="50" FontSize="15"
         Validation.ErrorTemplate="{StaticResource validationTemplate}"
         Style="{StaticResource textBoxInError}"
         Grid.Row="1" Grid.Column="1" Margin="2">
  <TextBox.Text>
    <Binding Path="Age" Source="{StaticResource ods}"
             UpdateSourceTrigger="PropertyChanged" >
      <Binding.ValidationRules>
        <c:AgeRangeRule Min="21" Max="130"/>
      </Binding.ValidationRules>
    </Binding>
  </TextBox.Text>
</TextBox>

L’exemple suivant montre l’implémentation de AgeRangeRule, qui hérite et ValidationRule remplace la Validate méthode. La Int32.Parse méthode est appelée sur la valeur pour s’assurer qu’elle ne contient pas de caractères non valides. La Validate méthode retourne une ValidationResult valeur qui indique si la valeur est valide en fonction de si une exception est interceptée pendant l’analyse et si la valeur d’âge est en dehors des limites inférieures et supérieures.

public class AgeRangeRule : ValidationRule
{
    public int Min { get; set; }
    public int Max { get; set; }

    public AgeRangeRule()
    {
    }

    public override ValidationResult Validate(object value, CultureInfo cultureInfo)
    {
        int age = 0;

        try
        {
            if (((string)value).Length > 0)
                age = Int32.Parse((String)value);
        }
        catch (Exception e)
        {
            return new ValidationResult(false, $"Illegal characters or {e.Message}");
        }

        if ((age < Min) || (age > Max))
        {
            return new ValidationResult(false,
              $"Please enter an age in the range: {Min}-{Max}.");
        }
        return ValidationResult.ValidResult;
    }
}

Public Class AgeRangeRule
    Inherits ValidationRule

    ' Properties
    Public Property Max As Integer
    Public Property Min As Integer
        
    ' Methods
    Public Overrides Function Validate(value As Object, cultureInfo As CultureInfo) As ValidationResult
        Dim num1 As Integer = 0
        Try 
            If (CStr(value).Length > 0) Then
                num1 = Integer.Parse(CStr(value))
            End If
        Catch exception1 As Exception
            Return New ValidationResult(False, $"Illegal characters or {exception1.Message}")
        End Try
        If ((num1 < Min) OrElse (num1 > Max)) Then
            Return New ValidationResult(False, $"Please enter an age in the range: {Min}-{Max}.")
        End If
        Return ValidationResult.ValidResult
    End Function

End Class

L’exemple suivant montre la personnalisée ControlTemplatevalidationTemplate qui crée un point d’exclamation rouge pour avertir l’utilisateur d’une erreur de validation. Les modèles de contrôle sont utilisés pour redéfinir l’apparence d’un contrôle.

<ControlTemplate x:Key="validationTemplate">
  <DockPanel>
    <TextBlock Foreground="Red" FontSize="20">!</TextBlock>
    <AdornedElementPlaceholder/>
  </DockPanel>
</ControlTemplate>

Comme illustré dans l’exemple suivant, le ToolTip message d’erreur est créé à l’aide du style nommé textBoxInError. Si la valeur est HasErrortrue, le déclencheur définit l’info-bulle du courant TextBox sur sa première erreur de validation. La RelativeSource valeur est définie Selfsur , faisant référence à l’élément actuel.

<Style x:Key="textBoxInError" TargetType="{x:Type TextBox}">
  <Style.Triggers>
    <Trigger Property="Validation.HasError" Value="true">
      <Setter Property="ToolTip"
        Value="{Binding RelativeSource={x:Static RelativeSource.Self},
                        Path=(Validation.Errors)/ErrorContent}"/>
    </Trigger>
  </Style.Triggers>
</Style>

Pour obtenir l’exemple complet, consultez l’exemple De validation de liaison.

Notez que si vous ne fournissez pas de modèle d’erreur personnalisé, ErrorTemplate le modèle d’erreur par défaut apparaît pour fournir des commentaires visuels à l’utilisateur en cas d’erreur de validation. Pour plus d’informations, consultez la section relative à la validation de données de la rubrique Vue d’ensemble de la liaison de données. WpF fournit également une règle de validation intégrée qui intercepte les exceptions levées pendant la mise à jour de la propriété source de liaison. Pour plus d’informations, consultez ExceptionValidationRule.

Voir aussi