Binding.UpdateSourceTrigger 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 détermine le minutage des mises à jour sources de liaison pour les liaisons bidirectionnelle.
public:
property UpdateSourceTrigger UpdateSourceTrigger { UpdateSourceTrigger get(); void set(UpdateSourceTrigger value); };
UpdateSourceTrigger UpdateSourceTrigger();
void UpdateSourceTrigger(UpdateSourceTrigger value);
public UpdateSourceTrigger UpdateSourceTrigger { get; set; }
var updateSourceTrigger = binding.updateSourceTrigger;
binding.updateSourceTrigger = updateSourceTrigger;
Public Property UpdateSourceTrigger As UpdateSourceTrigger
<Binding UpdateSourceTrigger="updateSourceTriggerMemberName"/>
Valeur de propriété
Une des valeurs UpdateSourceTrigger . La valeur par défaut est Default, qui est évaluée comme un PropertyChanged comportement de mise à jour pour la plupart des propriétés de dépendance, mais l’évalue comme LostFocus pour la TextBox.Text propriété.
Remarques
Le comportement par défaut pour la plupart des propriétés de dépendance est PropertyChanged. Toutefois, le comportement par défaut de la propriété TextBox.Text est LostFocus. Pour une liaison à TextBox.Text, vous pouvez modifier ce UpdateSourceTrigger qui suit :
<TextBox Text="{x:Bind MyProperty, Mode=TwoWay, UpdateSourceTrigger=PropertyChanged}" />
Toutefois, il n’aura aucun effet sur un TextBox modèle de contrôle d’un autre contrôle, tel que NumberBox. Par exemple, ce UpdateSourceTrigger paramètre n’a aucun effet.
<!-- This UpdateSourceTrigger setting has no effect. -->
<NumberBox Text="{x:Bind MyProperty, Mode=TwoWay, UpdateSourceTrigger=PropertyChanged}"/>
Votre autre choix pour un comportement UpdateSourceTrigger consiste à définir la valeur sur Explicit. Lorsqu’une liaison bidirectionnelle a sa valeur UpdateSourceTrigger , Explicitvous devez appeler explicitement UpdateSource sur l’objet BindingExpression approprié pour que les valeurs cibles modifiées mettent à jour la source de données. Utilisez FrameworkElement.GetBindingExpression pour obtenir une BindingExpression à partir d’un objet où une liaison à une propriété de dépendance existe et que cette liaison est une liaison bidirectionnelle avec UpdateSourceTrigger="Explicit".
Vous ne pouvez pas définir les valeurs de propriété d’un objet Binding après que cette liaison a été attachée à un élément cible et à une propriété cible. Si vous tentez cette opération, vous obtiendrez une exception d’exécution.