ValidationRule Osztály

Definíció

Névtér:

System.Windows.Controls

Szerelvény:

PresentationFramework.dll

Lehetővé teszi egyéni szabály létrehozását a felhasználói bevitel érvényességének ellenőrzéséhez.

public ref class ValidationRule abstract

public abstract class ValidationRule

type ValidationRule = class

Public MustInherit Class ValidationRule

Öröklődés

Object

ValidationRule

Származtatott

System.Windows.Controls.DataErrorValidationRule

System.Windows.Controls.ExceptionValidationRule

System.Windows.Controls.NotifyDataErrorValidationRule

Példák

Az alábbi példa bemutatja, hogyan valósíthat meg érvényesítési szabályt. A bemeneti érték érvénytelen, ha nem numerikus karaktereket tartalmaz, vagy ha az alsó és a felső határon kívül esik. Ha a visszaadott ValidationResult érték érvénytelen, a ErrorContent tulajdonság a megfelelő hibaüzenetre van állítvaIsValid, a tulajdonság értéke pedig a false következő.

A teljes példa: Útmutató: Kötésérvényesítés implementálása.

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

Megjegyzések

Az WPF adatkötési modell használatakor társíthatja ValidationRules a kötésobjektumhoz. Egyéni szabályok létrehozásához hozzon létre egy alosztályt ennek az osztálynak, és implementálja a metódust Validate . Ha szükséges, használja a beépítettt ExceptionValidationRule, amely a forrásfrissítések során kiváltott kivételeket észleli, vagy a DataErrorValidationRuleforrásobjektum implementációja által IDataErrorInfo kiváltott hibákat ellenőrzi.

A kötési motor minden alkalommal ellenőrzi a kötéshez társított értékeket ValidationRule , amikor egy bemeneti értéket, vagyis a kötés céltulajdonságértékét a kötés forrástulajdonságának ad át.

Az adatérvényesítéssel kapcsolatos részletes információkért tekintse meg az adatkötések áttekintését.

A felhasználó által megadott adatok párbeszédpanelen való érvényesítéséről további információt a Párbeszédpanelek áttekintése című témakörben talál.

Konstruktorok

Name	Description
ValidationRule()	Inicializálja a ValidationRule osztály új példányát.
ValidationRule(ValidationStep, Boolean)	Inicializálja az osztály új példányát a ValidationRule megadott érvényesítési lépéssel és egy olyan értékkel, amely jelzi, hogy az érvényesítési szabály fut-e a cél frissítésekor.

Tulajdonságok

Name	Description
ValidatesOnTargetUpdated	Lekéri vagy beállít egy értéket, amely jelzi, hogy az érvényesítési szabály fut-e a Binding cél frissítésekor.
ValidationStep	Lekéri vagy beállítja az érvényesítési szabály futtatásakor.

Metódusok

Name	Description
Validate(Object, CultureInfo, BindingExpressionBase)	Érvényesítési ellenőrzéseket végez egy értéken.
Validate(Object, CultureInfo, BindingGroup)	Érvényesítési ellenőrzéseket végez egy értéken.
Validate(Object, CultureInfo)	Ha egy származtatott osztályban felül van bírálva, érvényesítési ellenőrzéseket hajt végre egy értéken.

Lásd még

• DataErrorValidationRule
• ExceptionValidationRule