Binding.ValidatesOnExceptions Özellik

Tanım

Ad Alanı:

System.Windows.Data

Bütünleştirilmiş Kod:

PresentationFramework.dll

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

public:
 property bool ValidatesOnExceptions { bool get(); void set(bool value); };

public bool ValidatesOnExceptions { get; set; }

member this.ValidatesOnExceptions : bool with get, set

Public Property ValidatesOnExceptions As Boolean

Özellik Değeri

Boolean

true öğesini eklemek ExceptionValidationRuleiçin ; değilse , false.

Örnekler

Aşağıdaki örnekler bir TextBoxiçindeki kullanıcı girişini doğrulamak için kullanılırValidatesOnExceptions. İlk örnek, özellik geçersiz bir özelliğe ayarlandığında özel durum Age oluşturan bir veri türü oluşturur.

public class PersonThrowException
{
    private int age;

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

            if (value < 0 || value > 150)
            {
                throw new ArgumentException("Age must not be less than 0 or greater than 150.");
            }
            age = value;
        }
    }
}

Public Class PersonThrowException
    Private m_age As Integer

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

            If value < 0 OrElse value > 150 Then
                Throw New ArgumentException("Age must not be less than 0 or greater than 150.")
            End If
            m_age = value
        End Set
    End Property
End Class

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

<StackPanel Margin="20">
  <StackPanel.Resources>
    
    <src:PersonThrowException 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>
      <!--By setting ValidatesOnExceptions to True, it checks for exceptions
        that are thrown during the update of the source property.
        An alternative syntax is to add <ExceptionValidationRule/> within
        the <Binding.ValidationRules> section.-->
      <Binding Path="Age" Source="{StaticResource data}"
               ValidatesOnExceptions="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 ExceptionValidationRule bir alternatif sağlar. ExceptionValidationRule, kaynak özelliğin güncelleştirmesi sırasında oluşturulan özel durumları denetleen yerleşik bir doğrulama kuralıdır. Bir özel durum oluşturulursa, bağlama altyapısı özel durumu içeren bir ValidationError oluşturur ve bunu ilişkili öğenin koleksiyonuna Validation.Errors ekler. Başka bir kural doğrulama sorunu oluşturmadığı sürece hata olmaması bu doğrulama geri bildirimini temizler.

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

• ValidatesOnDataErrors