ExceptionValidationRule ExceptionValidationRule ExceptionValidationRule ExceptionValidationRule Class

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
ExceptionValidationRuleExceptionValidationRuleExceptionValidationRuleExceptionValidationRule

Beispiele

Die ValidationRules -Eigenschaft nimmt eine Auflistung ValidationRule von-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 ExceptionValidationRule , die bewirkt, dass der 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 TextBox standardmäßig 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 ErrorTemplate schreiben, 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 ExceptionValidationRule der-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 UpdateSourceExceptionFilterCallbackdiese Ausnahmen mithilfe eines behandelt.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.

Eine Alternative ExceptionValidationRule Syntax zum expliziten Festlegen von ist das Festlegen der-Eigenschaft ValidatesOnExceptions true Binding für das MultiBinding -Objekt oder das-Objekt.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 ValidationRule, die von abgeleitet wird.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() ExceptionValidationRule() ExceptionValidationRule() ExceptionValidationRule()

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

Methoden

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
ToString() ToString() ToString() ToString()

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

(Inherited from Object)
Validate(Object, CultureInfo) Validate(Object, CultureInfo) Validate(Object, CultureInfo) Validate(Object, CultureInfo)

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

Validate(Object, CultureInfo, BindingExpressionBase) Validate(Object, CultureInfo, BindingExpressionBase) Validate(Object, CultureInfo, BindingExpressionBase) Validate(Object, CultureInfo, BindingExpressionBase)

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

(Inherited from ValidationRule)
Validate(Object, CultureInfo, BindingGroup) Validate(Object, CultureInfo, BindingGroup) Validate(Object, CultureInfo, BindingGroup) Validate(Object, CultureInfo, BindingGroup)

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

(Inherited from ValidationRule)

Eigenschaften

ValidatesOnTargetUpdated ValidatesOnTargetUpdated ValidatesOnTargetUpdated 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.

(Inherited from ValidationRule)
ValidationStep ValidationStep ValidationStep ValidationStep

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

(Inherited from ValidationRule)

Gilt für:

Siehe auch