ExceptionValidationRule Classe

Définition

Représente une règle qui recherche les exceptions levées pendant la mise à jour de la propriété de source de liaison.Represents a rule that checks for exceptions that are thrown during the update of the binding source property.

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
ExceptionValidationRule

Exemples

La ValidationRules propriété prend une collection d' ValidationRule objets.The ValidationRules property takes a collection of ValidationRule objects. L’exemple suivant utilise TextBox.Text comme propriété de cible de liaison StartPrice et (un entier) comme propriété de source de liaison.The following example uses TextBox.Text as the binding target property and StartPrice (an integer) as the binding source property. Quand l’utilisateur entre une valeur qui ne peut pas être convertie en un entier, une exception est levée ExceptionValidationRule , ce qui entraîne l’invalidation de la valeur cible par le.When the user enters a value that cannot be converted to an integer, an exception is thrown, which causes the ExceptionValidationRule to invalidate the target value.

<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 TextBox s’affiche avec une bordure rouge.By default, when there is a validation error, the TextBox appears with a red border. Si vous le souhaitez, vous pouvez écrire ErrorTemplate un personnalisé pour spécifier la façon dont vous souhaitez avertir l’utilisateur en cas d’erreur de validation.Optionally, you can write a custom ErrorTemplate to specify how you want to notify the user when there is a validation error.

Pour plus d’informations sur la validation des données, consultez vue d’ensemblede la liaison de données.For more information about data validation, see Data Binding Overview.

Pour obtenir l’exemple complet, consultez démonstration de la liaison de données.For the complete sample, see Data Binding Demo.

Remarques

Le WPFWPF modèle de liaison de données vous permet ValidationRules d’associer Binding à un objet.The WPFWPF data binding model enables you to associate ValidationRules with a Binding object. 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é de source de liaison.The ExceptionValidationRule class is a built-in rule that checks for exceptions that are thrown during the updates of the binding source property. Vous pouvez fournir une logique personnalisée pour spécifier comment le moteur de liaison gère ces exceptions à UpdateSourceExceptionFilterCallbackl’aide d’un.You can provide custom logic to specify how the binding engine handles these exceptions by using a UpdateSourceExceptionFilterCallback. Pour plus d'informations, consultez UpdateSourceExceptionFilter.For more information, see UpdateSourceExceptionFilter.

Une autre ExceptionValidationRule syntaxe pour définir explicitement est de définir la ValidatesOnExceptions propriété true sur sur votre Binding objet ou MultiBinding .An alternative syntax to setting the ExceptionValidationRule explicitly is to set the ValidatesOnExceptions property to true on your Binding or MultiBinding object.

Vous pouvez créer une règle personnalisée en créant une classe qui dérive de ValidationRule.You can create a custom rule by creating a class that derives from ValidationRule. Pour plus d’informations et pour obtenir une présentation détaillée de la validation des données, consultez vue d’ensemblede la liaison de données.For more information and a detailed discussion of data validation, see Data Binding Overview.

Constructeurs

ExceptionValidationRule()

Initialise une nouvelle instance de la classe ExceptionValidationRule.Initializes a new instance of the ExceptionValidationRule class.

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.Gets or sets a value that indicates whether the validation rule runs when the target of the Binding is updated.

(Hérité de ValidationRule)
ValidationStep

Obtient ou définit le moment auquel la règle de validation s'exécute.Gets or sets when the validation rule runs.

(Hérité de ValidationRule)

Méthodes

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetHashCode()

Sert de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l'objet en cours.Returns a string that represents the current object.

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

Exécute des contrôles de validation sur une valeur.Performs validation checks on a value.

Validate(Object, CultureInfo, BindingExpressionBase)

Exécute des contrôles de validation sur une valeur.Performs validation checks on a value.

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

Exécute des contrôles de validation sur une valeur.Performs validation checks on a value.

(Hérité de ValidationRule)

S’applique à

Voir aussi