Binding.Mode 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 indique le sens du flux de données dans la liaison.
public:
property BindingMode Mode { BindingMode get(); void set(BindingMode value); };BindingMode Mode();
void Mode(BindingMode value);public BindingMode Mode { get; set; }var bindingMode = binding.mode;
binding.mode = bindingMode;Public Property Mode As BindingMode<Binding Mode="bindingModeMemberName"/>
Valeur de propriété
Une des valeurs BindingMode . La valeur par défaut est OneWay : la source met à jour la cible, mais les modifications apportées à la valeur cible ne mettent pas à jour la source.
Exemples
Cet exemple montre comment définir le mode de liaison en XAML.
<TextBox x:Name="MyTextBox" Text="Text" Foreground="{Binding Brush1, Mode=OneWay}"/>
Remarques
Pour les liaisons OneWay et TwoWay , les modifications dynamiques apportées à la source ne se propagent pas automatiquement à la cible sans fournir de prise en charge à partir de la source. Vous devez implémenter l’interface INotifyPropertyChanged sur l’objet source afin que la source puisse signaler les modifications par le biais d’événements que le moteur de liaison écoute. Pour C# ou Microsoft Visual Basic, implémentez System.ComponentModel.INotifyPropertyChanged. Pour les extensions de composant Visual C++ (C++/CX), implémentez Windows::UI::Xaml::D ata::INotifyPropertyChanged.
Pour les liaisons TwoWay , les modifications apportées à la cible se propagent automatiquement à la source, sauf si la cible de liaison est la propriété TextBox.Text . Dans ce cas, la mise à jour se produit uniquement lorsque textBox perd le focus. En outre, il est possible de définir UpdateSourceTrigger sur les liaisons TwoWay sur Explicite, auquel cas vous contrôlez explicitement les mises à jour de la source en appelant UpdateSource.
Pour les liaisons OneTime et OneWay , les appels à SetValue modifient automatiquement la valeur cible et suppriment la liaison.
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.