MultiBinding Class

 

Describes a collection of Binding objects attached to a single binding target property.

Namespace:   System.Windows.Data
Assembly:  PresentationFramework (in PresentationFramework.dll)

System.Object
  System.Windows.Markup.MarkupExtension
    System.Windows.Data.BindingBase
      System.Windows.Data.MultiBinding

[<ContentPropertyAttribute("Bindings")>]
type MultiBinding = 
    class
        inherit BindingBase
        interface IAddChild
    end

NameDescription
System_CAPS_pubmethodMultiBinding()

Initializes a new instance of the MultiBinding class.

NameDescription
System_CAPS_pubpropertyBindingGroupName

Gets or sets the name of the BindingGroup to which this binding belongs.(Inherited from BindingBase.)

System_CAPS_pubpropertyBindings

Gets the collection of Binding objects within this MultiBinding instance.

System_CAPS_pubpropertyConverter

Gets or sets the converter to use to convert the source values to or from the target value.

System_CAPS_pubpropertyConverterCulture

Gets or sets the CultureInfo object that applies to any converter assigned to bindings wrapped by the MultiBinding or on the MultiBinding itself.

System_CAPS_pubpropertyConverterParameter

Gets or sets an optional parameter to pass to a converter as additional information.

System_CAPS_pubpropertyDelay

Gets or sets the amount of time, in milliseconds, to wait before updating the binding source after the value on the target changes.(Inherited from BindingBase.)

System_CAPS_pubpropertyFallbackValue

Gets or sets the value to use when the binding is unable to return a value.(Inherited from BindingBase.)

System_CAPS_pubpropertyMode

Gets or sets a value that indicates the direction of the data flow of this binding.

System_CAPS_pubpropertyNotifyOnSourceUpdated

Gets or sets a value that indicates whether to raise the SourceUpdated event when a value is transferred from the binding target to the binding source.

System_CAPS_pubpropertyNotifyOnTargetUpdated

Gets or sets a value that indicates whether to raise the TargetUpdated event when a value is transferred from the binding source to the binding target.

System_CAPS_pubpropertyNotifyOnValidationError

Gets or sets a value that indicates whether to raise the Error attached event on the bound element.

System_CAPS_pubpropertyStringFormat

Gets or sets a string that specifies how to format the binding if it displays the bound value as a string.(Inherited from BindingBase.)

System_CAPS_pubpropertyTargetNullValue

Gets or sets the value that is used in the target when the value of the source is null.(Inherited from BindingBase.)

System_CAPS_pubpropertyUpdateSourceExceptionFilter

Gets or sets a handler you can use to provide custom logic for handling exceptions that the binding engine encounters during the update of the binding source value. This is only applicable if you have associated the ExceptionValidationRule with your MultiBinding object.

System_CAPS_pubpropertyUpdateSourceTrigger

Gets or sets a value that determines the timing of binding source updates.

System_CAPS_pubpropertyValidatesOnDataErrors

Gets or sets a value that indicates whether to include the DataErrorValidationRule.

System_CAPS_pubpropertyValidatesOnExceptions

Gets or sets a value that indicates whether to include the ExceptionValidationRule.

System_CAPS_pubpropertyValidatesOnNotifyDataErrors

Gets or sets a value that indicates whether to include the NotifyDataErrorValidationRule.

System_CAPS_pubpropertyValidationRules

Gets the collection of ValidationRule objects for this instance of MultiBinding.

NameDescription
System_CAPS_pubmethodEquals(Object)

Determines whether the specified object is equal to the current object.(Inherited from Object.)

System_CAPS_protmethodFinalize()

Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.)

System_CAPS_pubmethodGetHashCode()

Serves as the default hash function. (Inherited from Object.)

System_CAPS_pubmethodGetType()

Gets the Type of the current instance.(Inherited from Object.)

System_CAPS_protmethodMemberwiseClone()

Creates a shallow copy of the current Object.(Inherited from Object.)

System_CAPS_pubmethodProvideValue(IServiceProvider)

Returns an object that should be set on the property where this binding and extension are applied.(Inherited from BindingBase.)

System_CAPS_pubmethodShouldSerializeBindings()

Indicates whether the Bindings property should be persisted.

System_CAPS_pubmethodShouldSerializeFallbackValue()

Returns a value that indicates whether serialization processes should serialize the effective value of the FallbackValue property on instances of this class.(Inherited from BindingBase.)

System_CAPS_pubmethodShouldSerializeTargetNullValue()

Returns a value that indicates whether the TargetNullValue property should be serialized.(Inherited from BindingBase.)

System_CAPS_pubmethodShouldSerializeValidationRules()

Indicates whether the ValidationRules property should be persisted.

System_CAPS_pubmethodToString()

Returns a string that represents the current object.(Inherited from Object.)

NameDescription
System_CAPS_pubinterfaceSystem_CAPS_privmethodIAddChild.AddChild(Object)

This API supports the product infrastructure and is not intended to be used directly from your code. Adds a child object.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIAddChild.AddText(String)

This API supports the product infrastructure and is not intended to be used directly from your code. Adds the text content of a node to the object.

You can specify multiple bindings in a MultiBinding object. When you use the MultiBinding object with a converter, it produces a final value for the binding target based on the values of those bindings. For example, color might be computed from red, blue, and green values, which can be values from the same or different binding source objects. When a value moves from the target to the sources, the target property value is translated to a set of values that are fed back into the bindings.

The values of the Mode and UpdateSourceTrigger properties determine the functionality of the MultiBinding and are used as the default values for all the bindings in the collection unless an individual binding overrides these properties. For example, if the Mode property on the MultiBinding object is set to TwoWay, then all the bindings in the collection are considered TwoWay unless you set a different Mode value on one of the bindings explicitly. For more information, see the Binding.Mode and Binding.UpdateSourceTrigger properties.

MultiBinding currently supports only objects of type Binding and not MultiBinding or PriorityBinding.

.NET Framework
Available since 3.0

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Return to top
Show: