Binding.ValidatesOnDataErrors Propiedad

Definición

Espacio de nombres:

System.Windows.Data

Ensamblado:

PresentationFramework.dll

Obtiene o establece un valor que indica si se va a incluir el objeto DataErrorValidationRule.

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

Valor de propiedad

Boolean

Es true si se va a incluir el objeto DataErrorValidationRule; de lo contrario, es false.

Ejemplos

En los ejemplos siguientes se usa IDataErrorInfo y ValidatesOnDataErrors para validar la entrada del usuario en .TextBox En el primer ejemplo se crea un tipo de datos que implementa IDataErrorInfo para notificar errores de validación.

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

En el ejemplo siguiente se enlaza la Age propiedad a y TextBox se establece true ValidatesOnDataErrors en en .Binding Cuando el usuario escribe un valor no válido, aparece un borde rojo en y TextBox notifica ToolTip el mensaje de error.

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

Comentarios

Establecer esta propiedad proporciona una alternativa al uso del DataErrorValidationRule elemento explícitamente. DataErrorValidationRule es una regla de validación integrada que comprueba si hay errores generados por la IDataErrorInfo implementación del objeto de origen. Si se produce un error, el motor de enlace crea un ValidationError objeto con el error y lo agrega a la Validation.Errors colección del elemento enlazado. La falta de un error borra estos comentarios de validación, a menos que otra regla genere un problema de validación.

ValidatesOnDataErrors se introduce en .NET Framework versión 3.5. Para más información, consulte Versiones y dependencias de .NET Framework.

Consulte también

• ValidatesOnExceptions