ExceptionValidationRule Klasse

  • Referenz

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, 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)
Validate(Object, CultureInfo)

Führt Validierungsprüfungen für einen Wert aus.

Gilt für:

Weitere Informationen