BindingMode 枚举

定义

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

编辑

描述数据如何在绑定中传播。

public enum class BindingMode

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
enum class BindingMode

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public enum BindingMode

Public Enum BindingMode

<object property="enumMemberName"/>

设备系列	Windows 10 (在 10.0.10240.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

OneTime	2	创建绑定时，汇报目标属性。
OneWay	1	创建绑定时，汇报目标属性。对源对象的更改也可以传播到目标。
TwoWay	3	当任一更改时，汇报目标对象或源对象。创建绑定时，将从源更新目标属性。

此示例演示如何在 XAML 中设置绑定模式。

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

对于 OneWay 和 TwoWay 绑定，对源的动态更改不会自动传播到目标。必须在源对象上实现 INotifyPropertyChanged 接口才能发生这种情况。

对于 TwoWay 绑定，对目标的更改会自动传播到源，除非绑定目标是 Text 属性。在这种情况下，仅当 TextBox 失去焦点时才会进行更新。

对于 OneTime 和 OneWay 绑定，调用 DependencyObject.SetValue 会自动更改目标值并删除绑定。