ValidationRule Classe

Définition

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
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 si elle contient des caractères non numériques ou si elle est en dehors des limites inférieure et supérieure. Si la valeur de la propriété retournée ValidationResult n’est pas valide, la ErrorContent propriété est définie sur le message d’erreur approprié et la IsValid propriété a la valeur false .

Pour obtenir un exemple complet, consultez Comment : 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. Vous pouvez également utiliser le intégré ExceptionValidationRule , qui intercepte les exceptions levées pendant les mises à jour de la source, ou le DataErrorValidationRule , qui recherche les erreurs déclenchées par l' IDataErrorInfo implémentation de l’objet source.

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

Pour plus d’informations sur la validation des données, consultez vue d’ensemblede 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