ValidationRule ValidationRule ValidationRule ValidationRule Class

Définition

Permet de créer une règle personnalisée pour vérifier la validation de l'entrée 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
ValidationRuleValidationRuleValidationRuleValidationRule
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é ValidationResult retournée n’est ErrorContent pas valide, la propriété est définie sur le message IsValid d’erreur approprié et falsela propriété a la valeur.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 lavalidation de liaison.For the complete example, see How to: Implement Binding Validation.

public class AgeRangeRule : ValidationRule
{
    private int _min;
    private int _max;

    public AgeRangeRule()
    {
    }

    public int Min
    {
        get { return _min; }
        set { _min = value; }
    }

    public int Max
    {
        get { return _max; }
        set { _max = value; }
    }

    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 + ".");
        }
        else
        {
            return ValidationResult.ValidResult;
        }
    }
}

Remarques

Lorsque vous utilisez le WPFWPF modèle de liaison de données, vous ValidationRules pouvez associer à 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 Validate et implémentez la 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 ValidationRule chaque 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() ValidationRule() ValidationRule() ValidationRule()

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

ValidationRule(ValidationStep, Boolean) ValidationRule(ValidationStep, Boolean) ValidationRule(ValidationStep, Boolean) 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 ValidatesOnTargetUpdated ValidatesOnTargetUpdated 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 ValidationStep ValidationStep 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) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

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

(Inherited from Object)
Validate(Object, CultureInfo) Validate(Object, CultureInfo) Validate(Object, CultureInfo) Validate(Object, CultureInfo)

En cas de substitution dans une classe dérivée, exécute des contrôles de validation sur une valeur.When overridden in a derived class, performs validation checks on a value.

Validate(Object, CultureInfo, BindingExpressionBase) Validate(Object, CultureInfo, BindingExpressionBase) Validate(Object, CultureInfo, BindingExpressionBase) Validate(Object, CultureInfo, BindingExpressionBase)

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

Validate(Object, CultureInfo, BindingGroup) Validate(Object, CultureInfo, BindingGroup) Validate(Object, CultureInfo, BindingGroup) Validate(Object, CultureInfo, BindingGroup)

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

S’applique à

Voir aussi