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 akzeptiert eine Auflistung von ValidationRule Objekte.The ValidationRules property takes a collection of ValidationRule objects. Im folgenden Beispiel wird TextBox.Text als die Bindungsziel-Eigenschaft und StartPrice (eine ganze Zahl) als Bindungsquellen-Eigenschaft.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, die in eine ganze Zahl konvertiert werden kann, eine Ausnahme ausgelöst wird, wodurch die ExceptionValidationRule ungültig gemacht werden, den Zielwert.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 Überprüfungsfehler vorliegt, wird standardmäßig die TextBox mit einem roten Rahmen angezeigt wird.By default, when there is a validation error, the TextBox appears with a red border. Optional können Sie eine benutzerdefinierte schreiben ErrorTemplate angeben, wie den Benutzer zu benachrichtigen, wenn ein Validierungsfehler werden sollen.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 von finden Sie unter Übersicht über die Datenbindung.For more information about data validation, see Data Binding Overview.

Das vollständige Beispiel finden Sie unter Demo für die Datenbindung.For the complete sample, see Data Binding Demo.

Hinweise

Die WPFWPF -Datenbindungsmodell ermöglicht Ihnen die Zuordnung ValidationRules mit einem Binding Objekt.The WPFWPF data binding model enables you to associate ValidationRules with a Binding object. Die ExceptionValidationRule Klasse ist eine integrierte Validierungsregel, die zur Überprüfung von Ausnahmen, die während der Aktualisierung der Bindungsquelleigenschaft 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 benutzerdefinierten Logik angeben, wie die Bindungs-Engine diese Ausnahmen mit verarbeitet Bereitstellen einer 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.

Eine alternative Syntax zum Festlegen der ExceptionValidationRule explizit besteht darin, die ValidatesOnExceptions Eigenschaft, um true auf Ihre Binding oder MultiBinding 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 abgeleitete Klasse erstellen ValidationRule.You can create a custom rule by creating a class that derives from ValidationRule. Weitere Informationen und eine detaillierte Erläuterung der datenüberprüfung, 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