Binding.ValidatesOnDataErrors Özellik

Tanım

Ad Alanı:

System.Windows.Data

Bütünleştirilmiş Kod:

PresentationFramework.dll

öğesinin dahil DataErrorValidationRuleedilip edilmeyeceğini belirten bir değer alır veya ayarlar.

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

Özellik Değeri

Boolean

trueöğesini eklemek için ; değilse, DataErrorValidationRuleöğesini ekleyinfalse.

Örnekler

Aşağıdaki örneklerde bir IDataErrorInfoiçindeki kullanıcı girişini doğrulamak için ve ValidatesOnDataErrors kullanılırTextBox. İlk örnek, doğrulama hatalarını bildirmek için uygulayan IDataErrorInfo bir veri türü oluşturur.

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

Aşağıdaki örnek, özelliğini öğesine Age bağlar TextBox ve üzerinde ValidatesOnDataErrorsolarak true ayarlarBinding. Kullanıcı geçersiz bir değer girdiğinde, içinde kırmızı bir kenarlık görünür TextBox ve ToolTip hata iletisini bildirir.

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

Açıklamalar

Bu özelliğin ayarlanması, öğesini açıkça kullanmaya DataErrorValidationRule bir alternatif sağlar. DataErrorValidationRule, kaynak nesnenin uygulanması tarafından IDataErrorInfo oluşturulan hataları denetleen yerleşik bir doğrulama kuralıdır. Bir hata oluşursa, bağlama altyapısı hatayla bir ValidationError oluşturur ve bunu ilişkili öğenin koleksiyonuna Validation.Errors ekler. Hata olmaması, başka bir kural doğrulama sorunu oluşturmadığı sürece bu doğrulama geri bildirimini temizler.

ValidatesOnDataErrors, .NET Framework sürüm 3.5'te kullanıma sunulmuştur. Daha fazla bilgi için bkz. .NET Framework Sürümleri ve Bağımlılıkları .

Ayrıca bkz.

• ValidatesOnExceptions