Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

ValidationRule classe

 

Date de publication : novembre 2016

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

Espace de noms:   System.Windows.Controls
Assembly:  PresentationFramework (dans PresentationFramework.dll)


public abstract class ValidationRule

NomDescription
System_CAPS_protmethodValidationRule()

Initialise une nouvelle instance de la classe ValidationRule.

System_CAPS_protmethodValidationRule(ValidationStep, Boolean)

Initialise une nouvelle instance de la ValidationRule classe 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.

NomDescription
System_CAPS_pubpropertyValidatesOnTargetUpdated

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

System_CAPS_pubpropertyValidationStep

Obtient ou définit lorsque la règle de validation s’exécute.

NomDescription
System_CAPS_pubmethodEquals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_protmethodFinalize()

Autorise un objet à tenter de libérer des ressources et à exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par une opération garbage collection.(Hérité de Object.)

System_CAPS_pubmethodGetHashCode()

Fait office de fonction de hachage par défaut.(Hérité de Object.)

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_protmethodMemberwiseClone()

Crée une copie superficielle du Object actuel.(Hérité de Object.)

System_CAPS_pubmethodToString()

Retourne une chaîne qui représente l'objet actuel.(Hérité de Object.)

System_CAPS_pubmethodValidate(Object, CultureInfo)

En cas de remplacement dans une classe dérivée, effectue des contrôles de validation sur une valeur.

System_CAPS_pubmethodValidate(Object, CultureInfo, BindingExpressionBase)

Effectue des contrôles de validation sur une valeur.

System_CAPS_pubmethodValidate(Object, CultureInfo, BindingGroup)

Effectue des contrôles de validation sur une valeur.

Lorsque vous utilisez la WPF modèle de liaison de données, 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émenter la Validate méthode. Vous pouvez également utiliser la fonction intégrée ExceptionValidationRule, qui intercepte les exceptions levées pendant les mises à jour de la source, ou le DataErrorValidationRule, qui cherche les erreurs déclenchées par le 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 propriété cible de liaison, à la propriété de source de liaison.

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

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 dépasse les limites inférieure et supérieure. Si la valeur de retourné ValidationResult n’est pas valide, le ErrorContent est définie sur le message d’erreur approprié et la IsValid est définie sur false.

Pour un exemple complet, consultez la page Comment : implémenter la Validation de liaison.

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 new ValidationResult(true, null);
        }
    }
}

.NET Framework
Disponible depuis 3.0

Tous les membres statiques publics ( Shared en Visual Basic) de ce type sont thread-safe. Les membres d’instance n’ont pas la garantie d’être thread-safe.

Retour au début
Afficher: