Binding.ValidatesOnDataErrors Eigenschaft

Definition

Ruft einen Wert ab, der angibt, ob die DataErrorValidationRule eingeschlossen werden soll, oder legt diesen fest.

public:
 property bool ValidatesOnDataErrors { bool get(); void set(bool value); };
public bool ValidatesOnDataErrors { get; set; }
member this.ValidatesOnDataErrors : bool with get, set
Public Property ValidatesOnDataErrors As Boolean

Eigenschaftswert

Boolean

true, wenn die DataErrorValidationRule eingeschlossen werden soll, andernfalls false.

Beispiele

In den folgenden Beispielen wird die IDataErrorInfo ValidatesOnDataErrors Benutzereingabe in einer TextBox. Im ersten Beispiel wird ein Datentyp erstellt, der zum Melden von Überprüfungsfehlern IDataErrorInfo implementiert wird.

public class PersonImplementsIDataErrorInfo : IDataErrorInfo
{
    private int age;

    public int Age
    {
        get { return age; }
        set { age = value; }
    }

    public string Error
    {
        get
        {
            return "";
        }
    }

    public string this[string name]
    {
        get
        {
            string result = null;

            if (name == "Age")
            {
                if (this.age < 0 || this.age > 150)
                {
                    result = "Age must not be less than 0 or greater than 150.";
                }
            }
            return result;
        }
    }
}
Public Class PersonImplementsIDataErrorInfo
    Implements System.ComponentModel.IDataErrorInfo
    Private m_age As Integer

    Public Property Age() As Integer
        Get
            Return m_age
        End Get
        Set(ByVal value As Integer)
            m_age = value
        End Set
    End Property

    Public ReadOnly Property [Error]() As String _
                    Implements System.ComponentModel.IDataErrorInfo.Error
        Get
            Return ""
        End Get
    End Property

    Default Public ReadOnly Property Item(ByVal name As String) As String _
                            Implements System.ComponentModel.IDataErrorInfo.Item
        Get
            Dim result As String = Nothing

            If name = "Age" Then
                If Me.m_age < 0 OrElse Me.m_age > 150 Then
                    result = "Age must not be less than 0 or greater than 150."
                End If
            End If
            Return result
        End Get
    End Property
End Class

Im folgenden Beispiel wird die Eigenschaft an TextBox die eigenschaft gebunden und für das BindingElement festgelegt ValidatesOnDataErrors true.Age Wenn der Benutzer einen ungültigen Wert eingibt, wird in der TextBox Fehlermeldung ein roter Rahmen angezeigt.ToolTip

<StackPanel Margin="20">
  <StackPanel.Resources>
    <src:PersonImplementsIDataErrorInfo x:Key="data"/>
    
    <!--The tool tip for the TextBox to display the validation error message.-->
    <Style x:Key="textBoxInError" TargetType="TextBox">
      <Style.Triggers>
        <Trigger Property="Validation.HasError" Value="true">
          <Setter Property="ToolTip"
              Value="{Binding RelativeSource={x:Static RelativeSource.Self},
              Path=(Validation.Errors)[0].ErrorContent}"/>
        </Trigger>
      </Style.Triggers>
    </Style>

  </StackPanel.Resources>
  <TextBlock>Enter your age:</TextBlock>
  <TextBox Style="{StaticResource textBoxInError}">
    <TextBox.Text>
      <!--ValidatesOnDataErrors to is set to True, so the Binding
          checks for errors raised by the IDataErrorInfo object.
          An alternative syntax is to add <DataErrorValidationRule/> within
          the <Binding.ValidationRules> section.-->
      <Binding Path="Age" Source="{StaticResource data}"
               ValidatesOnDataErrors="True"
               UpdateSourceTrigger="PropertyChanged">
      </Binding>
    </TextBox.Text>
  </TextBox>
  <TextBlock>Mouse-over to see the validation error message.</TextBlock>
</StackPanel>

Hinweise

Wenn Sie diese Eigenschaft festlegen, wird eine Alternative zur expliziten Verwendung des DataErrorValidationRule Elements bereitgestellt. Dies DataErrorValidationRule ist eine integrierte Gültigkeitsprüfungsregel, die auf Fehler überprüft, die durch die IDataErrorInfo Implementierung des Quellobjekts ausgelöst werden. Wenn ein Fehler ausgelöst wird, erstellt das Bindungsmodul einen ValidationError Mit dem Fehler und fügt ihn zur Validation.Errors Auflistung des gebundenen Elements hinzu. Das Fehlen eines Fehlers löscht dieses Überprüfungsfeedback, es sei denn, eine andere Regel löst ein Überprüfungsproblem aus.

ValidatesOnDataErrorswird in der .NET Framework Version 3.5 eingeführt. Weitere Informationen finden Sie unter .NET Framework-Versionen und -Abhängigkeiten.

Gilt für

Siehe auch