ValidationRule Třída

  • Reference

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é

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 odpovídající chybovou zprávu a IsValid vlastnost je nastavena na false.

Ú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í datové vazby WPF model 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ý ExceptionValidationRuleobjekt , který zachytává výjimky, které jsou vyvolány během aktualizací zdroje, nebo DataErrorValidationRule, které kontroluje chyby vyvolané implementací IDataErrorInfo zdrojového objektu.

Modul vazeb zkontroluje 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 data poskytnutá uživatelem v dialogovém okně, naleznete v tématu Přehled dialogových oken.

Konstruktory

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

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

Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.

(Zděděno od Object)
GetHashCode()

Slouží jako výchozí funkce hash.

(Zděděno od Object)
GetType()

Type Získá aktuální instanci.

(Zděděno od Object)
MemberwiseClone()

Vytvoří použádnou kopii aktuálního souboru Object.

(Zděděno od Object)
ToString()

Vrátí řetězec, který představuje aktuální objekt.

(Zděděno od Object)
Validate(Object, CultureInfo)

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

Provádí kontroly ověření hodnoty.
Validate(Object, CultureInfo, BindingGroup)

Provádí kontroly ověření hodnoty.

Platí pro

Viz také