ValidationRule Classe

  • Référence

Définition

Espace de noms:
System.Windows.Controls
Assembly:
PresentationFramework.dll

Fournit un moyen de créer une règle personnalisée pour vérifier la validité de l’entrée d’utilisateur.

public ref class ValidationRule abstract
public abstract class ValidationRule
type ValidationRule = class
Public MustInherit Class ValidationRule
Héritage
Object
ValidationRule
Dérivé

Exemples

L’exemple suivant montre comment implémenter une règle de validation. La valeur d’entrée n’est pas valide s’il contient des caractères non numériques ou s’il se trouve en dehors des limites inférieures et supérieures. Si la valeur du retour ValidationResult n’est pas valide, la ErrorContent propriété est définie sur le message d’erreur approprié et la IsValid propriété est définie falsesur .

Pour obtenir l’exemple complet, consultez Guide pratique pour implémenter la validation de liaison.

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;
    }
}

Remarques

Lorsque vous utilisez le modèle de liaison de données WPF, vous pouvez associer ValidationRules votre objet de liaison. Pour créer des règles personnalisées, créez une sous-classe de cette classe et implémentez la Validate méthode. Si vous le souhaitez, utilisez le composant ExceptionValidationRuleintégré, qui intercepte les exceptions levées pendant les mises à jour sources, ou le DataErrorValidationRule, qui recherche les erreurs déclenchées par l’implémentation IDataErrorInfo de l’objet source.

Le moteur de liaison vérifie chaque ValidationRule liaison associée à une liaison chaque fois qu’elle transfère une valeur d’entrée, qui est la valeur de propriété de la cible de liaison, à la propriété source de liaison.

Pour plus d’informations sur la validation des données, consultez Vue d’ensemble de la liaison de données.

Pour plus d’informations sur la validation des données fournies par l’utilisateur dans une boîte de dialogue, consultez Vue d’ensemble des boîtes de dialogue.

Constructeurs

ValidationRule()

Initialise une nouvelle instance de la classe ValidationRule.
ValidationRule(ValidationStep, Boolean)

Initialise une nouvelle instance de la classe ValidationRule avec l'étape de validation spécifiée et une valeur qui indique si la règle de validation s'exécute lorsque la cible est mise à jour.

Propriétés

ValidatesOnTargetUpdated

Obtient ou définit une valeur qui indique si la règle de validation s'exécute lorsque la cible de Binding est mise à jour.
ValidationStep

Obtient ou définit le moment auquel la règle de validation s'exécute.

Méthodes

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)
Validate(Object, CultureInfo)

En cas de remplacement dans une classe dérivée, effectue des contrôles de validation sur une valeur.
Validate(Object, CultureInfo, BindingExpressionBase)

Exécute des contrôles de validation sur une valeur.
Validate(Object, CultureInfo, BindingGroup)

Exécute des contrôles de validation sur une valeur.

S’applique à

Voir aussi