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 对象与转换器一起使用时，它会根据这些绑定的值为绑定目标生成最终值。 例如，颜色可以从红色、蓝色和绿色值计算，这些值可以是来自相同或不同的绑定源对象的值。 当值从目标移动到源时，目标属性值将转换为一组返回绑定的值。

这些 Mode 值和 UpdateSourceTrigger 属性确定集合中所有绑定的功能 MultiBinding ，并用作集合中所有绑定的默认值，除非单个绑定重写这些属性。 例如，如果Mode对象上的MultiBinding属性设置为TwoWay，则除非显式对其中一个绑定设置不同的Mode值，否则将考虑TwoWay集合中的所有绑定。 有关详细信息，请参阅和Binding.ModeBinding.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	获取或设置一个处理程序，可用于提供自定义逻辑来处理绑定引擎在更新绑定源值期间遇到的异常。 仅当已与MultiBinding对象关联ExceptionValidationRule时，这才适用。
UpdateSourceTrigger	获取或设置一个值，该值确定绑定源更新的计时。
ValidatesOnDataErrors	获取或设置一个值，该值指示是否包含 .DataErrorValidationRule
ValidatesOnExceptions	获取或设置一个值，该值指示是否包含 .ExceptionValidationRule
ValidatesOnNotifyDataErrors	获取或设置一个值，该值指示是否包含 .NotifyDataErrorValidationRule
ValidationRules	获取此实例MultiBinding的对象集合ValidationRule。

方法

名称	说明
ProvideValue(IServiceProvider)	返回应在应用此绑定和扩展的属性上设置的对象。 (继承自 BindingBase)
ShouldSerializeBindings()	指示是否 Bindings 应保留该属性。
ShouldSerializeFallbackValue()	返回一个值，该值指示序列化进程是否应在此类实例上序列化属性的有效值 FallbackValue 。 (继承自 BindingBase)
ShouldSerializeTargetNullValue()	返回一个值，该值指示是否 TargetNullValue 应序列化属性。 (继承自 BindingBase)
ShouldSerializeValidationRules()	指示是否 ValidationRules 应保留该属性。

显式接口实现

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

另请参阅

• IMultiValueConverter