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 BindingModePublic Enum BindingMode<object property="enumMemberName"/>
- 继承
-
BindingMode
- 属性
Windows 要求
| 设备系列 |
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 会自动更改目标值并删除绑定。