Validation.Errors Angefügte Eigenschaft

Definition

Namespace:

System.Windows.Controls

Assembly:

PresentationFramework.dll

Ruft die Auflistung aller aktiven ValidationError-Objekte für das gebundene Element ab.

see GetErrors

see GetErrors

see GetErrors

Hinweise

Der Inhalt dieser Sammlung kann von der Anwendung nicht geändert werden. Ein Beispiel für die Verwendung dieser angefügten Eigenschaft finden Sie im Abschnitt Beispiel.

Mit dem WPF-Datenbindungsmodell können Sie Ihrem Binding Objekt zuordnenValidationRules. Die Überprüfung erfolgt während der Bindung von Ziel-zu-Bindung-Quellwertübertragungen, bevor der Konverter aufgerufen wird. Im Folgenden wird der Validierungsprozess beschrieben:

1. Wenn ein Wert von der Zieleigenschaft in die Quelleigenschaft übertragen wird, entfernt die Datenbindungs-Engine zunächst alle ValidationError Elemente, die der System.Windows.Controls.Validation.Errors angefügten Eigenschaft des gebundenen Elements hinzugefügt wurden. Anschließend wird überprüft, ob benutzerdefinierte ValidationRules für diesen Bindingdefiniert sind. In diesem Fall wird die Validate -Methode für jedes der ValidationRules aufgerufen, bis einer von ihnen einen Fehler aufweist oder bis alle von ihnen erfolgreich sind.

2. Sobald eine benutzerdefinierte Regel nicht übergeben wird, erstellt das Bindungsmodul ein ValidationError -Objekt und fügt es der System.Windows.Controls.Validation.Errors Auflistung des gebundenen Elements hinzu. Wenn System.Windows.Controls.Validation.Errors nicht leer ist, wird die angefügte Eigenschaft System.Windows.Controls.Validation.HasError des Elements auf true festgelegt. Wenn außerdem die NotifyOnValidationError-Eigenschaft der Binding auf true festgelegt ist, löst die Bindungs-Engine das angefügte Ereignis System.Windows.Controls.Validation.Error des Elements aus.

3. Wenn alle Regeln erfolgreich sind, ruft die Bindungs-Engine den Konverter auf, falls vorhanden.

4. Wenn der Konverter übergeben wird, ruft die Bindungs-Engine den Setter der Quelleigenschaft auf.

5. Wenn der Bindung ein ExceptionValidationRule zugeordnet ist und während Schritt 4 eine Ausnahme ausgelöst wird, überprüft das Bindungsmodul, ob ein UpdateSourceExceptionFiltervorhanden ist. Sie können den UpdateSourceExceptionFilter-Rückruf verwenden, um einen benutzerdefinierten Handler zum Behandeln von Ausnahmen bereitzustellen. Wenn kein UpdateSourceExceptionFilter für die Binding angegeben ist, erstellt die Bindungs-Engine einen ValidationError mit der Ausnahme und fügt ihn der System.Windows.Controls.Validation.Errors-Auflistung des gebundenen Elements hinzu.

Beachten Sie außerdem, dass ein gültiger Werttransfer in beide Richtungen (Ziel zu Quelle oder Quelle zu Ziel) das ValidationLöscht.Errorsangefügte Eigenschaft.

Informationen zum Verhalten dieser Eigenschaft in MultiBinding Szenarien finden Sie unter ValidationError.

Weitere Informationen finden Sie unter "Datenvalidierung" in der Datenbindungsübersicht.

XAML-Textverwendung

Siehe Hinweise. Die Errors Sammlung selbst ist nicht vom Benutzer festgelegt, aber Sie können sie in einer Steuerelementvorlagendefinition in XAML verwenden.

Informationen zur Abhängigkeitseigenschaft

Bezeichnerfeld	ErrorsProperty
Metadateneigenschaften auf true festgelegt	IsNotDataBindable