ExceptionValidationRule Classe

  • Référence

Définition

Espace de noms:
System.Windows.Controls
Assembly:
PresentationFramework.dll

Représente une règle qui recherche les exceptions levées pendant la mise à jour de la propriété de source de liaison.

public ref class ExceptionValidationRule sealed : System::Windows::Controls::ValidationRule
public sealed class ExceptionValidationRule : System.Windows.Controls.ValidationRule
type ExceptionValidationRule = class
    inherit ValidationRule
Public NotInheritable Class ExceptionValidationRule
Inherits ValidationRule
Héritage
Object
ValidationRule
ExceptionValidationRule

Exemples

La ValidationRules propriété prend une collection d’objets ValidationRule . L’exemple suivant utilise TextBox.Text comme propriété cible de liaison et StartPrice (un entier) comme propriété source de liaison. Lorsque l’utilisateur entre une valeur qui ne peut pas être convertie en entier, une exception est levée, ce qui entraîne l’invalidation ExceptionValidationRule de la valeur cible.

<TextBox Name="StartPriceEntryForm" Grid.Row="2" Grid.Column="1"
    Style="{StaticResource textStyleTextBox}" Margin="8,5,0,5">
  <TextBox.Text>
    <Binding Path="StartPrice" UpdateSourceTrigger="PropertyChanged">
      <Binding.ValidationRules>
        <ExceptionValidationRule />
      </Binding.ValidationRules>
    </Binding>
  </TextBox.Text>
</TextBox>

Par défaut, en cas d’erreur de validation, le s’affiche TextBox avec une bordure rouge. Si vous le souhaitez, vous pouvez écrire un personnalisé ErrorTemplate pour spécifier la façon dont vous souhaitez informer l’utilisateur en cas d’erreur de validation.

Pour plus d’informations sur la validation des données, consultez Vue d’ensemble de la liaison de données.

Pour obtenir l’exemple complet, consultez Démonstration de liaison de données.

Remarques

Le modèle de liaison de données WPF vous permet de l’associer ValidationRules à un Binding objet. La ExceptionValidationRule classe est une règle intégrée qui vérifie les exceptions levées pendant les mises à jour de la propriété source de liaison. Vous pouvez fournir une logique personnalisée pour spécifier la façon dont le moteur de liaison gère ces exceptions à l’aide d’un UpdateSourceExceptionFilterCallback. Pour plus d'informations, consultez UpdateSourceExceptionFilter.

Une autre syntaxe pour définir explicitement la propriété ExceptionValidationRule est de définir la propriété ValidatesOnExceptions sur true sur votre objet Binding ou MultiBinding.

Vous pouvez créer une règle personnalisée en créant une classe qui dérive de ValidationRule. Pour plus d’informations et une présentation détaillée de la validation des données, consultez Vue d’ensemble de la liaison de données.

Constructeurs

ExceptionValidationRule()

Initialise une nouvelle instance de la classe ExceptionValidationRule.

Propriétés

ValidatesOnTargetUpdated

Obtient ou définit une valeur qui indique si la règle de validation s'exécute lorsque la cible de Binding est mise à jour.

(Hérité de ValidationRule)
ValidationStep

Obtient ou définit le moment auquel la règle de validation s'exécute.

(Hérité de ValidationRule)

Méthodes

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)
Validate(Object, CultureInfo, BindingExpressionBase)

Exécute des contrôles de validation sur une valeur.

(Hérité de ValidationRule)
Validate(Object, CultureInfo, BindingGroup)

Exécute des contrôles de validation sur une valeur.

(Hérité de ValidationRule)
Validate(Object, CultureInfo)

Exécute des contrôles de validation sur une valeur.

S’applique à

Voir aussi