Binding.UpdateSourceTrigger Propriété

Définition

Espace de noms:

Windows.UI.Xaml.Data

Obtient ou définit une valeur qui détermine le minutage des mises à jour de la source 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é

UpdateSourceTrigger

Une des valeurs UpdateSourceTrigger . La valeur par défaut est Default, qui s’évalue comme un PropertyChanged comportement de mise à jour pour la plupart des propriétés de dépendance, mais é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 le UpdateSourceTrigger comme suit :

<TextBox Text="{x:Bind MyProperty, Mode=TwoWay, UpdateSourceTrigger=PropertyChanged}" />

Toutefois, cela n’aura aucun effet sur un TextBox dans le 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. -->
<muxc: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 la 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 GetBindingExpression pour obtenir un BindingExpression à partir d’un objet où il existe une propriété Binding à une propriété de dépendance et où 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.

Voir aussi

• UpdateSource()
• Mode
• GetBindingExpression(DependencyProperty)
• SetBinding(DependencyObject, DependencyProperty, BindingBase)
• Exemple de liaison de données XAML
• Présentation détaillée de la liaison de données
• Vue d’ensemble des propriétés de dépendance