Binding.ValidatesOnExceptions Propriété

Définition

Obtient ou définit une valeur qui indique s'il faut inclure ExceptionValidationRule.

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

Valeur de propriété

true pour inclure ExceptionValidationRule ; sinon, false.

Exemples

Les exemples suivants utilisent ValidatesOnExceptions pour valider l’entrée utilisateur dans un TextBox. Le premier exemple crée un type de données qui lève une exception lorsque la Age propriété est définie sur une propriété non valide.

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

L’exemple suivant lie la Age propriété à et TextBox définit ValidatesOnExceptions sur true sur .Binding Lorsque l’utilisateur entre une valeur non valide, une bordure rouge s’affiche dans et TextBox signale ToolTip le message d’erreur.

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

Remarques

La définition de cette propriété offre une alternative à l’utilisation explicite de l’élément ExceptionValidationRule . est ExceptionValidationRule une règle de validation intégrée qui vérifie les exceptions levées lors de la mise à jour de la propriété source. Si une exception est levée, le moteur de liaison crée un ValidationError avec l’exception et l’ajoute à la Validation.Errors collection de l’élément lié. L’absence d’erreur efface ce commentaire de validation, sauf si une autre règle soulève un problème de validation.

ValidatesOnExceptions est introduit dans le .NET Framework version 3.5. Pour plus d’informations, consultez Versions et dépendances du .NET Framework.

S’applique à

Voir aussi