ExceptionValidationRule Klasse

Definition

Namespace:

System.Windows.Controls

Assembly:

PresentationFramework.dll

Stellt eine Regel dar, die auf Ausnahmen prüft, die während der Aktualisierung der Bindungsquelleigenschaft ausgelöst werden.

public ref class ExceptionValidationRule sealed : System::Windows::Controls::ValidationRule

public sealed class ExceptionValidationRule : System.Windows.Controls.ValidationRule

type ExceptionValidationRule = class
    inherit ValidationRule

Public NotInheritable Class ExceptionValidationRule
Inherits ValidationRule

Vererbung

Object

ValidationRule

ExceptionValidationRule

Beispiele

Die ValidationRules -Eigenschaft akzeptiert eine Auflistung von ValidationRule -Objekten. Im folgenden Beispiel wird als Bindungszieleigenschaft und StartPrice (eine ganze Zahl) als Bindungsquelleigenschaft verwendetTextBox.Text. Wenn der Benutzer einen Wert eingibt, der nicht in eine ganze Zahl konvertiert werden kann, wird eine Ausnahme ausgelöst, die dazu führt, dass der ExceptionValidationRule Zielwert ungültig wird.

<TextBox Name="StartPriceEntryForm" Grid.Row="2" Grid.Column="1"
    Style="{StaticResource textStyleTextBox}" Margin="8,5,0,5">
  <TextBox.Text>
    <Binding Path="StartPrice" UpdateSourceTrigger="PropertyChanged">
      <Binding.ValidationRules>
        <ExceptionValidationRule />
      </Binding.ValidationRules>
    </Binding>
  </TextBox.Text>
</TextBox>

Wenn ein Validierungsfehler auftritt, TextBox wird standardmäßig ein roter Rahmen angezeigt. Optional können Sie eine benutzerdefinierte ErrorTemplate schreiben, um anzugeben, wie Sie den Benutzer benachrichtigen möchten, wenn ein Validierungsfehler auftritt.

Weitere Informationen zur Datenüberprüfung finden Sie unter Übersicht über die Datenbindung.

Das vollständige Beispiel finden Sie unter Demo zur Datenbindung.

Hinweise

Mit dem WPF-Datenbindungsmodell können Sie einem Binding Objekt zuordnenValidationRules. Die ExceptionValidationRule -Klasse ist eine integrierte Regel, die nach Ausnahmen sucht, die während der Aktualisierungen der Bindungsquelleigenschaft ausgelöst werden. Sie können mithilfe einer UpdateSourceExceptionFilterCallbackbenutzerdefinierten Logik angeben, wie die Bindungs-Engine diese Ausnahmen behandelt. Weitere Informationen finden Sie unter UpdateSourceExceptionFilter.

Alternativ zum expliziten Festlegen der ExceptionValidationRule können Sie die ValidatesOnExceptions-Eigenschaft des true- oder Binding-Objekts auf MultiBinding festlegen.

Sie können eine benutzerdefinierte Regel erstellen, indem Sie eine Klasse erstellen, die von abgeleitet wird ValidationRule. Weitere Informationen und eine ausführliche Erläuterung der Datenüberprüfung finden Sie unter Übersicht über die Datenbindung.

Konstruktoren

ExceptionValidationRule()

Initialisiert eine neue Instanz der ExceptionValidationRule-Klasse.

Eigenschaften

ValidatesOnTargetUpdated	Ruft einen Wert ab, der angibt, ob die Validierungsregel ausgeführt wird, wenn das Ziel der Binding aktualisiert wird, oder legt diesen Wert fest. (Geerbt von ValidationRule)
ValidationStep	Ruft ab oder legt fest, wann die Validierungsregel ausgeführt wird. (Geerbt von ValidationRule)

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
Validate(Object, CultureInfo)	Führt Validierungsprüfungen für einen Wert aus.
Validate(Object, CultureInfo, BindingExpressionBase)	Führt Validierungsprüfungen für einen Wert aus. (Geerbt von ValidationRule)
Validate(Object, CultureInfo, BindingGroup)	Führt Validierungsprüfungen für einen Wert aus. (Geerbt von ValidationRule)

Weitere Informationen

• ValidationRule
• DataErrorValidationRule