Binding.ValidatesOnExceptions Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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, setPublic Property ValidatesOnExceptions As BooleanValeur de propriété
true pour inclure ExceptionValidationRule ; sinon, false.
Exemples
Les exemples suivants permettent ValidatesOnExceptions de 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é à la TextBox propriété et la true définit ValidatesOnExceptions sur le Binding. Lorsque l’utilisateur entre une valeur non valide, une bordure rouge apparaît dans le TextBox message d’erreur et 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 . Il ExceptionValidationRule s’agit d’une règle de validation intégrée qui recherche 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 une ValidationError exception avec l’exception et l’ajoute à la Validation.Errors collection de l’élément lié. L’absence d’erreur efface ce retour de validation, sauf si une autre règle déclenche un problème de validation.
ValidatesOnExceptionsest introduit dans la .NET Framework version 3.5. Pour plus d’informations, consultez Versions et dépendances du .NET Framework.