Binding.UpdateSourceExceptionFilter, propriété

ExceptionValidationRule est une règle de validation intégrée qui cherche les exceptions levées pendant la mise à jour de la propriété de source de liaison. Si vous avez associé ExceptionValidationRule à votre objet Binding, vous pouvez utiliser cette propriété pour définir un gestionnaire pour fournir une logique personnalisée pour la gestion de ces exceptions. Si aucun UpdateSourceExceptionFilter n'est spécifié pour Binding, le moteur de liaison crée une ValidationError avec l'exception et l'ajoute à la collection Validation.Errors de l'élément lié.

La propriété Text de la TextBox suivante est liée aux données d'une propriété source Age3 de type int. ExceptionValidationRule vérifie si des exceptions sont levées au cours de la mise à jour de la propriété source (par exemple, lorsque l'utilisateur entre une valeur qui ne peut pas être convertie en un entier).

<TextBox Name="textBox3" Width="50" FontSize="15"
         Grid.Row="4" Grid.Column="1" Margin="2"
         Validation.ErrorTemplate="{StaticResource validationTemplate}"
         Style="{StaticResource textBoxInError}">
  <TextBox.Text>
    <Binding Path="Age3" Source="{StaticResource ods}"
             UpdateSourceTrigger="PropertyChanged">
      <Binding.ValidationRules>
        <ExceptionValidationRule/>
      </Binding.ValidationRules>
    </Binding>
  </TextBox.Text>
</TextBox>

Vous pouvez fournir la logique personnalisée pour gérer ces exceptions. L'exemple suivant montre comment utiliser la propriété UpdateSourceExceptionFilter pour définir un UpdateSourceExceptionFilterCallback.

BindingExpression myBindingExpression = textBox3.GetBindingExpression(TextBox.TextProperty);
Binding myBinding = myBindingExpression.ParentBinding;
myBinding.UpdateSourceExceptionFilter = new UpdateSourceExceptionFilterCallback(ReturnExceptionHandler);
myBindingExpression.UpdateSource();

L'exemple suivant illustre l'implémentation de UpdateSourceExceptionFilterCallback.

object ReturnExceptionHandler(object bindingExpression, Exception exception)
{
    return "This is from the UpdateSourceExceptionFilterCallBack.";
}

UpdateSourceExceptionFilterCallback peut également retourner la valeur null, l'exception elle-même ou ValidationError. Pour plus d'informations, consultez UpdateSourceExceptionFilterCallback.

Pour l'exemple complet, consultez Binding Validation Sample.

.NET Framework

.NET Framework Client Profile

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Référence

Autres ressources