ValidationRule Sınıf

  • Başvuru

Tanım

Ad Alanı:
System.Windows.Controls
Bütünleştirilmiş Kod:
PresentationFramework.dll

Kullanıcı girişinin geçerliliğini denetlemek için özel kural oluşturmanın bir yolunu sağlar.

public ref class ValidationRule abstract
public abstract class ValidationRule
type ValidationRule = class
Public MustInherit Class ValidationRule
Devralma
Object
ValidationRule
Türetilmiş

Örnekler

Aşağıdaki örnekte bir doğrulama kuralının nasıl uygulandığı gösterilmektedir. Giriş değeri, sayısal olmayan karakterler içeriyorsa veya alt ve üst sınırların dışındaysa geçersizdir. Döndürülen ValidationResult değeri geçersizse, ErrorContent özelliği uygun hata iletisine ayarlanır ve IsValid özelliği olarak falseayarlanır.

Tam örnek için bkz . Nasıl yapılır: Bağlama Doğrulaması Uygulama.

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

Açıklamalar

WPF veri bağlama modelini kullandığınızda bağlama nesnenizle ilişkilendirebilirsiniz ValidationRules . Özel kurallar oluşturmak için bu sınıfın bir alt sınıfını oluşturun ve yöntemini uygulayın Validate . İsteğe bağlı olarak, kaynak güncelleştirmeler sırasında oluşturulan özel durumları yakalayan yerleşik ExceptionValidationRuleöğesini veya DataErrorValidationRulekaynak nesnenin uygulanması tarafından IDataErrorInfo oluşturulan hataları denetleyen öğesini kullanın.

Bağlama altyapısı bağlama kaynağı özelliğine bağlama hedef özelliği değeri olan bir giriş değerini her aktarışında bağlamayla ilişkili her ValidationRule bir değeri denetler.

Veri doğrulama hakkında ayrıntılı bilgi için bkz. Veri Bağlamaya Genel Bakış.

Bir iletişim kutusunda kullanıcı tarafından sağlanan verileri doğrulama hakkında bilgi için bkz. İletişim Kutularına Genel Bakış.

Oluşturucular

ValidationRule()

ValidationRule sınıfının yeni bir örneğini başlatır.
ValidationRule(ValidationStep, Boolean)

Belirtilen doğrulama adımı ve hedef güncelleştirildiğinde geçerlilik kuralının ValidationRule çalışıp çalışmadığını gösteren bir değerle sınıfının yeni bir örneğini başlatır.

Özellikler

ValidatesOnTargetUpdated

öğesinin hedefi Binding güncelleştirildiğinde geçerlilik kuralının çalışıp çalışmadığını belirten bir değer alır veya ayarlar.
ValidationStep

Doğrulama kuralı çalıştırıldığında alır veya ayarlar.

Yöntemler

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

(Devralındığı yer: Object)
GetHashCode()

Varsayılan karma işlevi işlevi görür.

(Devralındığı yer: Object)
GetType()

Type Geçerli örneğini alır.

(Devralındığı yer: Object)
MemberwiseClone()

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: Object)
ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.

(Devralındığı yer: Object)
Validate(Object, CultureInfo)

Türetilmiş bir sınıfta geçersiz kılındığında, değer üzerinde doğrulama denetimleri gerçekleştirir.
Validate(Object, CultureInfo, BindingExpressionBase)

Değer üzerinde doğrulama denetimleri gerçekleştirir.
Validate(Object, CultureInfo, BindingGroup)

Değer üzerinde doğrulama denetimleri gerçekleştirir.

Şunlara uygulanır

Ayrıca bkz.