ValidationError Sınıf

Tanım

Ad Alanı:

System.Windows.Controls

Bütünleştirilmiş Kod:

PresentationFramework.dll

Bir doğrulama hatası bildirdiğinde ValidationRule bağlama altyapısı tarafından veya yöntemi aracılığıyla açıkça oluşturulan bir doğrulama hatasını MarkInvalid(BindingExpressionBase, ValidationError) temsil eder.

public ref class ValidationError

public class ValidationError

type ValidationError = class

Public Class ValidationError

Devralma

Object

ValidationError

Örnekler

Aşağıdaki örnekte, doğrulama hata iletisini bildiren bir ToolTip stil tetikleyicisi gösterilmektedir. Validation.Errors Ekli özellik, ilişkili öğedeki bir nesne koleksiyonu ValidationError döndürür.

<Style x:Key="textStyleTextBox" TargetType="TextBox">
  <Setter Property="Foreground" Value="#333333" />
  <Setter Property="MaxLength" Value="40" />
  <Setter Property="Width" Value="392" />
  <Style.Triggers>
    <Trigger Property="Validation.HasError" Value="true">
      <Setter Property="ToolTip"
        Value="{Binding RelativeSource={RelativeSource Self},
                        Path=(Validation.Errors)[0].ErrorContent}"/>
    </Trigger>
  </Style.Triggers>
</Style>

Açıklamalar

WPF veri bağlama modeli, doğrulama kurallarını nesnenizle ilişkilendirmenizi Binding sağlar. Doğrulama, dönüştürücü çağrılmadan önce hedef kaynak değer aktarımı sırasında gerçekleşir. Aşağıda doğrulama işlemi açıklanmaktadır.

1. Bir değer hedef özelliğinden kaynak özelliğine aktarılırken, veri bağlama altyapısı önce ilişkili öğenin ekli özelliğine Validation.Errors eklenmiş olabilecekleri ValidationError kaldırır. Ardından, bu için herhangi bir özel doğrulama kuralının tanımlanıp tanımlanmadığını Bindingdenetler. Bu durumda, biri başarısız olana kadar veya hepsi geçene kadar her ValidationRule birinde yöntemini çağırırValidate.

2. Geçmeyen özel bir kural olduğunda, bağlama altyapısı bir ValidationError nesne oluşturur ve bunu ilişkili öğenin koleksiyonuna Validation.Errors ekler. Boş Validation.Errors olmadığında, öğesinin Validation.HasError ekli özelliği olarak trueayarlanır. Ayrıca özelliğinin NotifyOnValidationErrorBinding olarak ayarlanmış trueolması durumunda bağlama altyapısı öğesinde ekli olayı başlatır Validation.Error .

3. Tüm kurallar geçerse, bağlama altyapısı varsa dönüştürücüsünü çağırır.

4. Dönüştürücü geçerse, bağlama altyapısı kaynak özelliğin ayarlayıcısını çağırır.

5. Bağlamanın kendisiyle ilişkilendirilmiş bir ExceptionValidationRule örneği varsa ve 3 veya 4. adım sırasında bir özel durum oluşursa, bağlama altyapısı bir UpdateSourceExceptionFilterolup olmadığını denetler. Özel durumları işlemek için özel bir işleyici sağlamak üzere geri çağırmayı kullanabilirsiniz UpdateSourceExceptionFilter . üzerinde belirtilmezseUpdateSourceExceptionFilter, bağlama altyapısı özel durum içeren bir ValidationError oluşturur ve bunu Validation.Errors ilişkili öğenin koleksiyonuna ekler.Binding

Her iki yönde geçerli bir değer aktarımı (hedefe hedef veya hedefe kaynak) ekli özelliği temizler Validation.Errors .

Oluşturucular

Name	Description
ValidationError(ValidationRule, Object, Object, Exception)	Belirtilen parametrelerle sınıfının yeni bir örneğini ValidationError başlatır.
ValidationError(ValidationRule, Object)	Belirtilen parametrelerle sınıfının yeni bir örneğini ValidationError başlatır.

Özellikler

Name	Description
BindingInError	Bu ValidationErroröğesinin BindingExpression veya MultiBindingExpression nesnesini alır. Nesne açıkça geçersiz olarak işaretlendi veya doğrulama kuralı başarısız oldu.
ErrorContent	Bu ValidationErroriçin hatanın açıklandığı bir dize gibi ek bağlam sağlayan bir nesnesi alır veya ayarlar.
Exception	Hata bir özel durumun sonucuysa, bunun ValidationErrornedeni olan nesneyi alır veya ayarlarException.
RuleInError	Hata bir doğrulama kuralının ValidationRule sonucuysa, bunun ValidationErrornedeni olan nesneyi alır veya ayarlar.

Ayrıca bkz.

• DataErrorValidationRule
• ValidationRule
• MarkInvalid(BindingExpressionBase, ValidationError)