ValidationRule Třída

Definice

Obor názvů:

System.Windows.Controls

Sestavení:

PresentationFramework.dll

Poskytuje způsob, jak vytvořit vlastní pravidlo, aby bylo možné zkontrolovat platnost vstupu uživatele.

public ref class ValidationRule abstract

public abstract class ValidationRule

type ValidationRule = class

Public MustInherit Class ValidationRule

Dědičnost

Object

ValidationRule

Odvozené

System.Windows.Controls.DataErrorValidationRule

System.Windows.Controls.ExceptionValidationRule

System.Windows.Controls.NotifyDataErrorValidationRule

Příklady

Následující příklad ukazuje, jak implementovat ověřovací pravidlo. Vstupní hodnota je neplatná, pokud obsahuje nečíselné znaky nebo je mimo dolní a horní mez. Pokud je vrácená hodnota ValidationResult neplatná, ErrorContent vlastnost je nastavena na příslušnou chybovou IsValid zprávu a vlastnost je nastavena na falsehodnotu .

Úplný příklad najdete v tématu Postupy: Implementace ověřování vazby.

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

Poznámky

Při použití modelu datové vazby WPF můžete přidružit ValidationRules k objektu vazby. Chcete-li vytvořit vlastní pravidla, vytvořte podtřídu této třídy a implementujte metodu Validate . Volitelně můžete použít předdefinované ExceptionValidationRule, které zachytí výjimky, které jsou vyvolány během aktualizace zdroje, nebo DataErrorValidationRule, která kontroluje chyby vyvolané IDataErrorInfo implementací zdrojového objektu.

Modul vazeb kontroluje každý ValidationRule , který je přidružen k vazbě pokaždé, když přenese vstupní hodnotu, což je hodnota cílové vlastnosti vazby, do vlastnosti zdroje vazby.

Podrobné informace o ověření dat najdete v tématu Přehled datových vazeb.

Informace o tom, jak ověřit uživatelsky poskytnutá data v dialogovém okně, naleznete v tématu Přehled dialogových oken.

Konstruktory

Name	Description
ValidationRule()	Inicializuje novou instanci ValidationRule třídy.
ValidationRule(ValidationStep, Boolean)	Inicializuje novou instanci ValidationRule třídy se zadaným ověřovacím krokem a hodnotou, která označuje, jestli se ověřovací pravidlo spustí při aktualizaci cíle.

Vlastnosti

Name	Description
ValidatesOnTargetUpdated	Získá nebo nastaví hodnotu, která označuje, zda se ověřovací pravidlo spustí při aktualizaci cíle Binding .
ValidationStep	Získá nebo nastaví při spuštění ověřovacího pravidla.

Metody

Name	Description
Validate(Object, CultureInfo, BindingExpressionBase)	Provádí kontroly ověření hodnoty.
Validate(Object, CultureInfo, BindingGroup)	Provádí kontroly ověření hodnoty.
Validate(Object, CultureInfo)	Při přepsání v odvozené třídě provádí kontroly ověření hodnoty.

Viz také

• DataErrorValidationRule
• ExceptionValidationRule