Freigeben über


Validation.Errors Angefügte Eigenschaft

Definition

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

see GetErrors
see GetErrors
see GetErrors

Hinweise

Die Anwendung kann den Inhalt dieser Sammlung nicht ändern. Ein Beispiel für die Verwendung dieser angefügten Eigenschaft finden Sie im Abschnitt "Beispiel".

Mit dem WPF-Datenbindungsmodell können Sie ihr 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 Überprüfungsprozess beschrieben:

  1. Wenn ein Wert von der Zieleigenschaft in die Quelleigenschaft übertragen wird, entfernt das Datenbindungsmodul zuerst 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 ValidationRuleElemente dafür Bindingdefiniert sind. In diesem Fall ruft sie die Validate Methode für jedes s ValidationRuleauf, bis einer von ihnen zu einem Fehler oder bis alle übergeben wird.

  2. Sobald eine benutzerdefinierte Regel vorhanden ist, die 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 System.Windows.Controls.Validation.HasError angefügte Eigenschaft des Elements auf truefestgelegt. Wenn die NotifyOnValidationError Eigenschaft des Binding Elements festgelegt trueist, löst das Bindungsmodul außerdem das System.Windows.Controls.Validation.Error angefügte Ereignis für das Element aus.

  3. Wenn alle Regeln übergeben werden, ruft das Bindungsmodul den Konverter auf, falls vorhanden.

  4. Wenn der Konverter übergeben wird, ruft das Bindungsmodul den Setter der Quelleigenschaft auf.

  5. Wenn die Bindung mit ExceptionValidationRule dieser verknüpft ist und während Schritt 4 eine Ausnahme ausgelöst wird, überprüft das Bindungsmodul, ob es ein UpdateSourceExceptionFilter. Sie haben die Möglichkeit, den UpdateSourceExceptionFilter Rückruf zu verwenden, um einen benutzerdefinierten Handler für die Behandlung von Ausnahmen bereitzustellen. Wenn für UpdateSourceExceptionFilter das BindingBindungsmodul kein Wert angegeben ist, erstellt das Bindungsmodul eine ValidationError Ausnahme und fügt es der System.Windows.Controls.Validation.Errors Auflistung des gebundenen Elements hinzu.

Beachten Sie außerdem, dass eine gültige Wertübertragung in eine Richtung (Target-to-Source oder Source-to-Target) die ValidationErrors angefügte Eigenschaft löscht.

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

Weitere Informationen finden Sie unter "Datenüberprüfung" in der Datenbindungsübersicht.

XAML-Textverwendung

Weitere Informationen finden Sie in der "Anmerkungen". Die Errors Sammlung selbst ist nicht vom Benutzer festgelegt, aber Sie können sie in einer Steuerelementvorlagendefinition in XAML verwenden.

Informationen zur Abhängigkeitseigenschaft

Element Wert
Bezeichnerfeld ErrorsProperty
Auf Metadateneigenschaften festgelegt true IsNotDataBindable

Gilt für: