Freigeben über

ValidationError Klasse

Definition

Namespace:
System.Windows.Controls
Assembly:
PresentationFramework.dll

Stellt einen Überprüfungsfehler dar, der entweder vom Bindungsmodul erstellt wird, wenn ein ValidationRule Überprüfungsfehler oder die MarkInvalid(BindingExpressionBase, ValidationError) Methode explizit gemeldet wird.

public ref class ValidationError
public class ValidationError
type ValidationError = class
Public Class ValidationError
Vererbung
Object
ValidationError

Beispiele

Das folgende Beispiel zeigt einen Formatauslöser, der eine ToolTip Fehlermeldung zur Überprüfung meldet. Die Validation.Errors angefügte Eigenschaft gibt eine Auflistung von ValidationError Objekten im gebundenen Element zurück.

<Style x:Key="textStyleTextBox" TargetType="TextBox">
  <Setter Property="Foreground" Value="#333333" />
  <Setter Property="MaxLength" Value="40" />
  <Setter Property="Width" Value="392" />
  <Style.Triggers>
    <Trigger Property="Validation.HasError" Value="true">
      <Setter Property="ToolTip"
        Value="{Binding RelativeSource={RelativeSource Self},
                        Path=(Validation.Errors)[0].ErrorContent}"/>
    </Trigger>
  </Style.Triggers>
</Style>

Hinweise

Mit dem WPF-Datenbindungsmodell können Sie Ihrem Objekt Gültigkeitsprüfungsregeln Binding zuordnen. Die Überprüfung erfolgt während der Ziel-zu-Quelle-Wertübertragung, bevor der Konverter aufgerufen wird. Im Folgenden wird der Überprüfungsprozess beschrieben.

  1. Wenn ein Wert von der Zieleigenschaft in die Quelleigenschaft übertragen wird, entfernt das Datenbindungsmodul zunächst alle ValidationError Elemente, die Validation.Errors der angefügten Eigenschaft des gebundenen Elements hinzugefügt wurden. Anschließend wird überprüft, ob benutzerdefinierte Gültigkeitsprüfungsregeln dafür Bindingdefiniert sind. In diesem Fall ruft sie die Validate Methode für jeden ValidationRule auf, bis eine dieser Regeln fehlschlägt oder bis alle übergeben werden.

  2. Sobald eine benutzerdefinierte Regel vorhanden ist, die nicht übergeben wird, erstellt das Bindungsmodul ein ValidationError Objekt und fügt es der Validation.Errors Auflistung des gebundenen Elements hinzu. Wenn Validation.Errors nicht leer ist, wird die Validation.HasError angefügte Eigenschaft des Elements auf truefestgelegt. Wenn die NotifyOnValidationError Eigenschaft des Binding Elements festgelegt trueist, löst das Bindungsmodul außerdem das Validation.Error angefügte Ereignis für das Element aus.

  3. Wenn alle Regeln übergeben werden, ruft das Bindungsmodul den Konverter auf, falls vorhanden.

  4. Wenn der Konverter übergeben wird, ruft das Bindungsmodul den Setter der Quelleigenschaft auf.

  5. Wenn die Bindung mit ExceptionValidationRule der Bindung verknüpft ist und während Schritt 3 oder 4 eine Ausnahme ausgelöst wird, überprüft das Bindungsmodul, ob ein UpdateSourceExceptionFilterBindemodul vorhanden ist. Sie können den UpdateSourceExceptionFilter Rückruf verwenden, um einen benutzerdefinierten Handler für die Behandlung von Ausnahmen bereitzustellen. Wenn für UpdateSourceExceptionFilter das BindingBindungsmodul kein Wert angegeben ist, erstellt das Bindungsmodul eine ValidationError Ausnahme und fügt es der Validation.Errors Auflistung des gebundenen Elements hinzu.

Eine gültige Wertübertragung in beide Richtungen (Ziel für Quelle oder Quelle an Ziel) löscht die Validation.Errors angefügte Eigenschaft.

Konstruktoren

Name Beschreibung
ValidationError(ValidationRule, Object, Object, Exception)

Initialisiert eine neue Instanz der ValidationError Klasse mit den angegebenen Parametern.
ValidationError(ValidationRule, Object)

Initialisiert eine neue Instanz der ValidationError Klasse mit den angegebenen Parametern.

Eigenschaften

Name Beschreibung
BindingInError

Ruft das BindingExpression oder MultiBindingExpression Objekt dieses ValidationErrorab. Das Objekt ist entweder explizit als ungültig gekennzeichnet oder weist eine ungültige Gültigkeitsprüfungsregel auf.
ErrorContent

Dient zum Abrufen oder Festlegen eines Objekts, das zusätzlichen Kontext für dieses ValidationErrorObjekt bereitstellt, z. B. eine Zeichenfolge, die den Fehler beschreibt.
Exception

Ruft ab oder legt das Exception Objekt fest, das die Ursache für dieses ValidationErrorObjekt war, wenn der Fehler das Ergebnis einer Ausnahme ist.
RuleInError

Dient zum Abrufen oder Festlegen des ValidationRule Objekts, das die Ursache für dieses ValidationErrorObjekt war, wenn der Fehler das Ergebnis einer Gültigkeitsprüfungsregel ist.

Methoden

Name Beschreibung
Equals(Object)

Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht.

(Geerbt von Object)
GetHashCode()

Dient als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Gilt für:

Weitere Informationen