Udostępnij za pośrednictwem


Binding.ValidatesOnExceptions Właściwość

Definicja

Pobiera lub ustawia wartość wskazującą, czy należy uwzględnić ExceptionValidationRuleelement .

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

Wartość właściwości

true w celu uwzględnienia ; ExceptionValidationRulew przeciwnym razie false.

Przykłady

W poniższych przykładach użyto ValidatesOnExceptions metody do weryfikacji danych wejściowych użytkownika w elemecie TextBox. Pierwszy przykład tworzy typ danych, który zgłasza wyjątek, gdy Age właściwość jest ustawiona na nieprawidłową właściwość.

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

W poniższym przykładzie właściwość jest powiązana Age z właściwością TextBox i ustawia ValidatesOnExceptions wartość true na w obiekcie Binding. Gdy użytkownik wprowadzi nieprawidłową wartość, w TextBox obiekcie pojawi się czerwone obramowanie i ToolTip zostanie wyświetlony komunikat o błędzie.

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

Uwagi

Ustawienie tej właściwości stanowi alternatywę dla jawnego używania ExceptionValidationRule elementu. Jest ExceptionValidationRule to wbudowana reguła sprawdzania poprawności, która sprawdza wyjątki zgłaszane podczas aktualizacji właściwości źródłowej. Jeśli zostanie zgłoszony wyjątek, aparat powiązania tworzy ValidationError obiekt z wyjątkiem i dodaje go do Validation.Errors kolekcji powiązanego elementu. Brak błędu czyści tę opinię dotyczącą weryfikacji, chyba że inna reguła zgłasza problem z walidacją.

ValidatesOnExceptionsjest wprowadzana w .NET Framework w wersji 3.5. Aby uzyskać więcej informacji, zobacz .NET Framework Wersje i zależności.

Dotyczy

Zobacz też