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.Provides a way to create a custom rule in order to check the validity of user input.

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.The following example shows how to implement a validation rule. 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.The input value is invalid if it contains non-numeric characters or if it is outside the lower and upper bounds. 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 .If the value of the returned ValidationResult is invalid, the ErrorContent property is set to the appropriate error message and the IsValid property is set to false.

Pour obtenir un exemple complet, consultez Comment : implémenter la validation de liaison.For the complete example, see How to: Implement Binding Validation.

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 WPFWPF modèle de liaison de données, vous pouvez associer ValidationRules à votre objet de liaison.When you use the WPFWPF data binding model, you can associate ValidationRules with your binding object. Pour créer des règles personnalisées, créez une sous-classe de cette classe et implémentez la Validate méthode.To create custom rules, make a subclass of this class and implement the Validate method. 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.Optionally, use the built-in ExceptionValidationRule, which catches exceptions that are thrown during source updates, or the DataErrorValidationRule, which checks for errors raised by the IDataErrorInfo implementation of the source object.

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.The binding engine checks each ValidationRule that is associated with a binding every time it transfers an input value, which is the binding target property value, to the binding source property.

Pour plus d’informations sur la validation des données, consultez vue d’ensemblede la liaison de données.For detailed information about data validation, see Data Binding Overview.

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.For information about how to validate user-provided data in a dialog box, see Dialog Boxes Overview.

Constructeurs

ValidationRule()

Initialise une nouvelle instance de la classe ValidationRule.Initializes a new instance of the ValidationRule class.

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.Initializes a new instance of the ValidationRule class with the specified validation step and a value that indicates whether the validation rule runs when the target is updated.

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.Gets or sets a value that indicates whether the validation rule runs when the target of the Binding is updated.

ValidationStep

Obtient ou définit le moment auquel la règle de validation s'exécute.Gets or sets when the validation rule runs.

Méthodes

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetHashCode()

Sert de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(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.When overridden in a derived class, performs validation checks on a value.

Validate(Object, CultureInfo, BindingExpressionBase)

Exécute des contrôles de validation sur une valeur.Performs validation checks on a value.

Validate(Object, CultureInfo, BindingGroup)

Exécute des contrôles de validation sur une valeur.Performs validation checks on a value.

S’applique à

Voir aussi