BindingMode BindingMode BindingMode BindingMode Enum


Describes how the data propagates in a binding.

public : enum class BindingMode
enum class winrt::Windows::UI::Xaml::Data::BindingMode : int32_t
public enum BindingMode
Public Enum BindingMode
<object property="enumMemberName"/>

Windows 10 requirements

Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)


OneTime OneTime OneTime OneTime 2

Updates the target property when the binding is created.

OneWay OneWay OneWay OneWay 1

Updates the target property when the binding is created. Changes to the source object can also propagate to the target.

TwoWay TwoWay TwoWay TwoWay 3

Updates either the target or the source object when either changes. When the binding is created, the target property is updated from the source.


This example demonstrates how to set the binding mode in XAML.

<TextBox x:Name="MyTextBox" Text="Text" Foreground="{Binding Brush1, Mode=OneWay}"/>


For OneWay and TwoWay bindings, dynamic changes to the source don't automatically propagate to the target. You must implement the INotifyPropertyChanged interface on the source object for this to happen.

For TwoWay bindings, changes to the target automatically propagate to the source, except if the binding target is the Text property. In that case, the update happens only when the TextBox loses focus.

For OneTime and OneWay bindings, calls to DependencyObject.SetValue automatically change the target value and delete the binding.

See also