MultiBinding 类

定义

命名空间:

System.Windows.Data

程序集:

PresentationFramework.dll

描述附加到单个绑定目标属性的 Binding 对象的集合。

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

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

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

Public Class MultiBinding
Inherits BindingBase
Implements IAddChild

继承

Object

MarkupExtension

BindingBase

MultiBinding

属性

ContentPropertyAttribute

实现

IAddChild

注解

可以在 对象中 MultiBinding 指定多个绑定。 MultiBinding将 对象与转换器一起使用时，它会根据这些绑定的值为绑定目标生成最终值。 例如，颜色可能由红色、蓝色和绿色值计算，这些值可以是来自相同或不同绑定源对象的值。 当值从目标移动到源时，目标属性值被转换为一组值，这些值反馈回绑定。

和 UpdateSourceTrigger 属性的值Mode确定 的功能MultiBinding，并用作集合中所有绑定的默认值，除非单个绑定替代这些属性。 例如，如果 Mode 对象的 属性 MultiBinding 设置为 TwoWay，则考虑 TwoWay 集合中的所有绑定，除非显式地在其中一个绑定上设置了不同的 Mode 值。 有关详细信息，请参阅 Binding.Mode 和 Binding.UpdateSourceTrigger 属性。

MultiBinding 当前仅支持 Binding 类型的对象，而不支持 MultiBinding 或 PriorityBinding 类型的对象。

构造函数

MultiBinding()

初始化 MultiBinding 类的新实例。

属性

BindingGroupName	获取或设置此绑定所属的 BindingGroup 的名称。 (继承自 BindingBase)
Bindings	获取此 MultiBinding 实例中的 Binding 对象的集合。
Converter	获取或设置用于在源值和目标值之间来回转换的转换器。
ConverterCulture	获取或设置 CultureInfo 对象，该对象应用于任何分配给绑定（由 MultiBinding 包装或是在 MultiBinding 自身上）的转换器。
ConverterParameter	获取或设置要作为其他信息传递给转换器的可选参数。
Delay	获取或设置更新位于目标更改上的值之后的绑定源前要等待的时间（毫秒）。 (继承自 BindingBase)
FallbackValue	获取或设置当绑定无法返回值时要使用的值。 (继承自 BindingBase)
Mode	获取或设置一个值，该值指示此绑定的数据流的方向。
NotifyOnSourceUpdated	获取或设置一个值，该值指示当值从绑定目标传输到绑定源时是否引发 SourceUpdated 事件。
NotifyOnTargetUpdated	获取或设置一个值，该值指示当值从绑定源传输到绑定目标时是否引发 TargetUpdated 事件。
NotifyOnValidationError	获取或设置一个值，该值指示是否对绑定元素引发 Error 附加事件。
StringFormat	获取或设置一个字符串，该字符串指定如果绑定值显示为字符串，应如何设置该绑定的格式。 (继承自 BindingBase)
TargetNullValue	获取或设置当源的值为 null 时在目标中使用的值。 (继承自 BindingBase)
UpdateSourceExceptionFilter	获取或设置一个处理程序，可使用该程序提供自定义逻辑，旨在在更新绑定源值期间处理绑定引擎遇到的异常。 这仅适用于你已将 ExceptionValidationRule 与 MultiBinding 对象相关联的情况。
UpdateSourceTrigger	获取或设置一个值，它可确定绑定源更新的计时。
ValidatesOnDataErrors	获取或设置一个值，该值指示是否包含 DataErrorValidationRule。
ValidatesOnExceptions	获取或设置一个值，该值指示是否包含 ExceptionValidationRule。
ValidatesOnNotifyDataErrors	获取或设置一个值，该值指示是否包含 NotifyDataErrorValidationRule。
ValidationRules	获取此 MultiBinding 实例的 ValidationRule 对象的集合。

方法

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

显式接口实现

IAddChild.AddChild(Object)	添加子对象。
IAddChild.AddText(String)	将节点的文本内容添加到对象。

另请参阅

• IMultiValueConverter