ExceptionValidationRule Klasse

Definition

Stellt eine Regel dar, die auf Ausnahmen prüft, die während der Aktualisierung der Bindungsquelleigenschaft ausgelöst werden.Represents a rule that checks for exceptions that are thrown during the update of the binding source property.

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
ExceptionValidationRule

Beispiele

Die- ValidationRules Eigenschaft nimmt eine Auflistung von- ValidationRule Objekten an.The ValidationRules property takes a collection of ValidationRule objects. Im folgenden Beispiel wird TextBox.Text als Bindungs Ziel Eigenschaft und StartPrice (eine ganze Zahl) als Bindungs Quell Eigenschaft verwendet.The following example uses TextBox.Text as the binding target property and StartPrice (an integer) as the binding source property. Wenn der Benutzer einen Wert eingibt, der nicht in eine ganze Zahl konvertiert werden kann, wird eine Ausnahme ausgelöst, die bewirkt, dass der ExceptionValidationRule Zielwert ungültig wird.When the user enters a value that cannot be converted to an integer, an exception is thrown, which causes the ExceptionValidationRule to invalidate the target value.

<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 Validierungs Fehler vorliegt, wird der standardmäßig TextBox mit einem roten Rahmen angezeigt.By default, when there is a validation error, the TextBox appears with a red border. Optional können Sie einen benutzerdefinierten schreiben ErrorTemplate , um anzugeben, wie der Benutzer benachrichtigt werden soll, wenn ein Validierungs Fehler vorliegt.Optionally, you can write a custom ErrorTemplate to specify how you want to notify the user when there is a validation error.

Weitere Informationen zur Datenüberprüfung finden Sie unter Übersicht über die Datenbindung.For more information about data validation, see Data Binding Overview.

Das komplette Beispiel finden Sie unter Demo zur Datenbindung.For the complete sample, see Data Binding Demo.

Hinweise

Das WPFWPF Daten Bindungs Modell ermöglicht es Ihnen, ValidationRules einem- Binding Objekt zuzuordnen.The WPFWPF data binding model enables you to associate ValidationRules with a Binding object. Bei der ExceptionValidationRule -Klasse handelt es sich um eine integrierte Regel, die auf Ausnahmen prüft, die während der Aktualisierung der Bindungs Quell Eigenschaft ausgelöst werden.The ExceptionValidationRule class is a built-in rule that checks for exceptions that are thrown during the updates of the binding source property. Sie können eine benutzerdefinierte Logik bereitstellen, um anzugeben, wie die Bindungs-Engine diese Ausnahmen mithilfe eines behandelt UpdateSourceExceptionFilterCallback .You can provide custom logic to specify how the binding engine handles these exceptions by using a UpdateSourceExceptionFilterCallback. Weitere Informationen finden Sie unter UpdateSourceExceptionFilter.For more information, see UpdateSourceExceptionFilter.

Alternativ zum expliziten Festlegen der ExceptionValidationRule können Sie die ValidatesOnExceptions-Eigenschaft des true- oder Binding-Objekts auf MultiBinding festlegen.An alternative syntax to setting the ExceptionValidationRule explicitly is to set the ValidatesOnExceptions property to true on your Binding or MultiBinding object.

Sie können eine benutzerdefinierte Regel erstellen, indem Sie eine Klasse erstellen, die von abgeleitet wird ValidationRule .You can create a custom rule by creating a class that derives from ValidationRule. Weitere Informationen und eine ausführliche Erläuterung der Datenvalidierung finden Sie unter Übersicht über die Datenbindung.For more information and a detailed discussion of data validation, see Data Binding Overview.

Konstruktoren

ExceptionValidationRule()

Initialisiert eine neue Instanz der ExceptionValidationRule-Klasse.Initializes a new instance of the ExceptionValidationRule class.

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.Gets or sets a value that indicates whether the validation rule runs when the target of the Binding is updated.

(Geerbt von ValidationRule)
ValidationStep

Ruft ab oder legt fest, wann die Validierungsregel ausgeführt wird.Gets or sets when the validation rule runs.

(Geerbt von ValidationRule)

Methoden

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetHashCode()

Dient als die Standard-HashfunktionServes as the default hash function.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)
Validate(Object, CultureInfo)

Führt Validierungsprüfungen für einen Wert aus.Performs validation checks on a value.

Validate(Object, CultureInfo, BindingExpressionBase)

Führt Validierungsprüfungen für einen Wert aus.Performs validation checks on a value.

(Geerbt von ValidationRule)
Validate(Object, CultureInfo, BindingGroup)

Führt Validierungsprüfungen für einen Wert aus.Performs validation checks on a value.

(Geerbt von ValidationRule)

Gilt für:

Weitere Informationen