UpdateSourceExceptionFilterCallback Délégué

Définition

Représente la méthode qui gère les exceptions levées pendant la mise à jour de la valeur source de liaison.Represents the method that handles exceptions that are thrown during the update of the binding source value. Ceci doit être utilisé avec ExceptionValidationRule.This must be used with the ExceptionValidationRule.

public delegate System::Object ^ UpdateSourceExceptionFilterCallback(System::Object ^ bindExpression, Exception ^ exception);
public delegate object UpdateSourceExceptionFilterCallback(object bindExpression, Exception exception);
type UpdateSourceExceptionFilterCallback = delegate of obj * Exception -> obj
Public Delegate Function UpdateSourceExceptionFilterCallback(bindExpression As Object, exception As Exception) As Object 

Paramètres

bindExpression
Object

Objet avec l’exception.The object with the exception.

exception
Exception

Exception rencontrée.The exception encountered.

Valeur renvoyée

Object

Objet qui est généralement un des suivants :An object that is typically one of the following:

ValueValue DescriptionDescription
null Pour ignorer toutes les exceptions.To ignore any exceptions. Le comportement par défaut (en cas d'absence de UpdateSourceExceptionFilterCallback) consiste à créer une ValidationError avec l'exception pour l'ajouter à la collection de Errors de l'élément lié.The default behavior (if there is no UpdateSourceExceptionFilterCallback) is to create a ValidationError with the exception and adds it to the Errors collection of the bound element.
Tout objetAny object Pour créer un objet ValidationError avec ErrorContent défini pour cet objet.To create a ValidationError object with the ErrorContent set to that object. L'objet ValidationError est ajouté à la collection de Errors de l'élément lié.The ValidationError object is added to Errors collection of the bound element.
Objet ValidationError.A ValidationError object Pour définir l'objet BindingExpression ou MultiBindingExpression en tant que BindingInError.To set the BindingExpression or MultiBindingExpression object as the BindingInError. L'objet ValidationError est ajouté à la collection de Errors de l'élément lié.The ValidationError object is added to Errors collection of the bound element.
Héritage
UpdateSourceExceptionFilterCallback

Exemples

La Text propriété de l’exemple TextBox suivant est liée aux données d’une propriété Age3 source qui est de inttype.The Text property of the following TextBox is data-bound to a source property Age3 that is of type int. Vérifie ExceptionValidationRule les exceptions levées pendant la mise à jour de la propriété source (par exemple, lorsque l’utilisateur entre une valeur qui ne peut pas être convertie en entier).The ExceptionValidationRule checks for exceptions that are thrown during the update of the source property (such as when the user enters a value that cannot be converted to an integer).

<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 avez la possibilité de fournir une logique personnalisée pour gérer ces exceptions.You have the option to provide custom logic to handle those exceptions. L’exemple suivant montre comment utiliser la UpdateSourceExceptionFilter propriété pour définir un: UpdateSourceExceptionFilterCallbackThe following example shows how to use the UpdateSourceExceptionFilter property to set an UpdateSourceExceptionFilterCallback:


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

Voici un exemple d’implémentation d’un UpdateSourceExceptionFilterCallback:The following is an example implementation of an UpdateSourceExceptionFilterCallback:

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

Pour obtenir l’exemple complet, consultez exemple de validationde la liaison.For the complete sample, see Binding Validation Sample.

Remarques

Si vous avez associé ExceptionValidationRule à votre Binding objet, vous avez la possibilité d’utiliser la UpdateSourceExceptionFilter propriété pour définir ce rappel afin de fournir une logique personnalisée pour gérer les exceptions.If you have associated the ExceptionValidationRule with your Binding object you have the option to use the UpdateSourceExceptionFilter property to set this callback to provide custom logic for handling the exceptions. Ce rappel est appelé chaque fois qu’une exception est rencontrée lorsque le moteur de liaison met à jour la valeur de la source de liaison.This callback is invoked whenever any exception is encountered when the binding engine updates the binding source value.

Si un UpdateSourceExceptionFilter n’est pas spécifié Bindingsur, le moteur de liaison crée ValidationError un avec l’exception et l’ajoute à Validation.Errors la collection de l’élément lié.If an UpdateSourceExceptionFilter is not specified on the Binding, the binding engine creates a ValidationError with the exception and adds it to the Validation.Errors collection of the bound element.

Méthodes d’extension

GetMethodInfo(Delegate)

Obtient un objet qui représente la méthode représentée par le délégué spécifié.Gets an object that represents the method represented by the specified delegate.

S’applique à

Voir aussi