PriorityBinding 类

定义

命名空间:

System.Windows.Data

程序集:

PresentationFramework.dll

描述附加到单个绑定目标属性的 Binding 对象的集合，该属性从成功生成值的集合中的第一个绑定接收其值。

public ref class PriorityBinding : System::Windows::Data::BindingBase, System::Windows::Markup::IAddChild

[System.Windows.Markup.ContentProperty("Bindings")]
public class PriorityBinding : System.Windows.Data.BindingBase, System.Windows.Markup.IAddChild

[<System.Windows.Markup.ContentProperty("Bindings")>]
type PriorityBinding = class
    inherit BindingBase
    interface IAddChild

Public Class PriorityBinding
Inherits BindingBase
Implements IAddChild

继承

Object

MarkupExtension

BindingBase

PriorityBinding

属性

ContentPropertyAttribute

实现

IAddChild

注解

PriorityBinding 允许将绑定目标 (目标) 属性与绑定列表相关联。 成功返回值的第一个绑定将成为活动绑定。

在如下情况下，绑定成功返回值：

1. 绑定源的路径已成功解析。

2. 值转换器（如果有）能够转换生成的值。

3. 生成的值对目标属性有效。

该值 DependencyProperty.UnsetValue 不被视为成功的返回值。

绑定的优先级由它们在列表中的顺序决定。 列表中第一个显示的绑定具有最高优先级。

绑定引擎从列表中的第一个绑定开始，并验证该绑定是否成功返回值;如果存在，则使用该绑定中的值。 如果第一个绑定未成功返回值，绑定引擎将检查第二个绑定以确定它是否成功返回值;如果存在，则第二个绑定中的值将成为活动值。 此验证过程一直持续到绑定列表的末尾。 如果任何绑定都未成功返回值，则绑定将使用 FallbackValue。

绑定引擎继续侦听所有绑定的更改。 如果某个具有较高优先级的绑定在任意时间成功返回值，则该绑定的值将成为活动值并替换当前值。

构造函数

PriorityBinding()

初始化 PriorityBinding 类的新实例。

属性

BindingGroupName	获取或设置此绑定所属的 BindingGroup 的名称。 (继承自 BindingBase)
Bindings	获取 Binding 对象的集合，该集合是为 PriorityBinding 的此实例建立的。
Delay	获取或设置更新位于目标更改上的值之后的绑定源前要等待的时间（毫秒）。 (继承自 BindingBase)
FallbackValue	获取或设置当绑定无法返回值时要使用的值。 (继承自 BindingBase)
StringFormat	获取或设置一个字符串，该字符串指定如果绑定值显示为字符串，应如何设置该绑定的格式。 (继承自 BindingBase)
TargetNullValue	获取或设置当源的值为 null 时在目标中使用的值。 (继承自 BindingBase)

方法

Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
ProvideValue(IServiceProvider)	返回一个应在应用了此绑定和扩展的属性上设置的对象。 (继承自 BindingBase)
ShouldSerializeBindings()	返回一个值，该值指示序列化进程是否应当对此类的实例的 Bindings 有效属性值进行序列化。
ShouldSerializeFallbackValue()	返回一个值，该值指示序列化进程是否应当对此类的实例的 FallbackValue 有效属性值进行序列化。 (继承自 BindingBase)
ShouldSerializeTargetNullValue()	返回一个值，该值指示是否应序列化 TargetNullValue 属性。 (继承自 BindingBase)
ToString()	返回表示当前对象的字符串。 (继承自 Object)

显式接口实现

IAddChild.AddChild(Object)	此成员支持Windows Presentation Foundation (WPF) 基础结构，不应直接从代码中使用。
IAddChild.AddText(String)	此成员支持Windows Presentation Foundation (WPF) 基础结构，不应直接从代码中使用。

另请参阅

• PriorityBindingExpression
• IValueConverter