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 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é
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 , Explicit
vous 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.