MultiBinding MultiBinding MultiBinding MultiBinding Class

Определение

Описывает коллекцию объектов Binding, присоединенных к одному целевому свойству привязки. Describes a collection of Binding objects attached to a single binding target property.

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
type MultiBinding = class
    inherit BindingBase
    interface IAddChild
Public Class MultiBinding
Inherits BindingBase
Implements IAddChild
Наследование
Атрибуты
Реализации

Комментарии

Можно указать несколько привязок в MultiBinding объекта.You can specify multiple bindings in a MultiBinding object. При использовании MultiBinding объекта с преобразователем, он создает конечное значение для целевого объекта привязки на основе значений из этих привязок.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.

Значения Mode и UpdateSourceTrigger свойства определяют функциональность MultiBinding и используются как значения по умолчанию для всех привязок в коллекции, если отдельная привязка не переопределяет эти свойства.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. Например если Mode свойство MultiBinding имеет значение TwoWay, то рассматриваются все привязки в коллекции TwoWay Если не задать другой Mode значение на одну из привязок, явным образом.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. Дополнительные сведения см. в разделе Binding.Mode и Binding.UpdateSourceTrigger свойства.For more information, see the Binding.Mode and Binding.UpdateSourceTrigger properties.

MultiBinding в настоящее время поддерживает только объекты типа Binding, но не MultiBinding или PriorityBinding.MultiBinding currently supports only objects of type Binding and not MultiBinding or PriorityBinding.

Конструкторы

MultiBinding() MultiBinding() MultiBinding() MultiBinding()

Инициализирует новый экземпляр класса MultiBinding. Initializes a new instance of the MultiBinding class.

Свойства

BindingGroupName BindingGroupName BindingGroupName BindingGroupName

Возвращает или задает имя группы BindingGroup, к которой принадлежит данная привязка.Gets or sets the name of the BindingGroup to which this binding belongs.

(Inherited from BindingBase)
Bindings Bindings Bindings Bindings

Получает коллекцию объектов Binding в данном экземпляре MultiBinding. Gets the collection of Binding objects within this MultiBinding instance.

Converter Converter Converter Converter

Получает или задает преобразователь, который должен использоваться для преобразования исходных значений в целевое значение или из целевого значения. Gets or sets the converter to use to convert the source values to or from the target value.

ConverterCulture ConverterCulture ConverterCulture ConverterCulture

Получает или задает объекта CultureInfo, который применяется к любому преобразователю, присвоенному к привязкам, обтекаемым MultiBinding или самим MultiBinding. Gets or sets the CultureInfo object that applies to any converter assigned to bindings wrapped by the MultiBinding or on the MultiBinding itself.

ConverterParameter ConverterParameter ConverterParameter ConverterParameter

Получает или задает необязательный параметр для передачи в преобразователь в качестве дополнительных сведений. Gets or sets an optional parameter to pass to a converter as additional information.

Delay Delay Delay Delay

Получает или задает время (в миллисекундах) ожидания перед обновлением источника привязки после изменения значения в целевом объекте.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)
FallbackValue FallbackValue FallbackValue FallbackValue

Возвращает или задает значение, которое необходимо использовать, если привязка неспособна вернуть значение.Gets or sets the value to use when the binding is unable to return a value.

(Inherited from BindingBase)
Mode Mode Mode Mode

Получает или задает значение, указывающее направление потока данных этой привязки. Gets or sets a value that indicates the direction of the data flow of this binding.

NotifyOnSourceUpdated NotifyOnSourceUpdated NotifyOnSourceUpdated NotifyOnSourceUpdated

Возвращает или задает значение, указывающее, следует ли вызывать событие SourceUpdated, когда значение передается от целевого объекта привязки к источнику привязки. 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.

NotifyOnTargetUpdated NotifyOnTargetUpdated NotifyOnTargetUpdated NotifyOnTargetUpdated

Возвращает или задает значение, указывающее, следует ли вызывать событие TargetUpdated, когда значение передается от исходного объекта привязки к целевому объекту привязки. 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.

NotifyOnValidationError NotifyOnValidationError NotifyOnValidationError NotifyOnValidationError

Возвращает или задает значение, указывающее, следует ли вызывать присоединенное событие Error в привязанном элементе. Gets or sets a value that indicates whether to raise the Error attached event on the bound element.

StringFormat StringFormat StringFormat StringFormat

Возвращает или задает строку, указывающую способ форматирования привязки при отображении связанного значения в виде строки.Gets or sets a string that specifies how to format the binding if it displays the bound value as a string.

(Inherited from BindingBase)
TargetNullValue TargetNullValue TargetNullValue TargetNullValue

Возвращает или задает значение, используемое в целевом элементе, если значение источника равно null.Gets or sets the value that is used in the target when the value of the source is null.

(Inherited from BindingBase)
UpdateSourceExceptionFilter UpdateSourceExceptionFilter UpdateSourceExceptionFilter UpdateSourceExceptionFilter

Получает или задает обработчик, который можно использовать для предоставления пользовательской логики для обработки исключений, которые механизм привязки находит при обновлении значения источника привязки. 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. Это применимо только если ExceptionValidationRule связан с объектом MultiBinding. This is only applicable if you have associated the ExceptionValidationRule with your MultiBinding object.

UpdateSourceTrigger UpdateSourceTrigger UpdateSourceTrigger UpdateSourceTrigger

Получает или задает значение, определяющее расписание обновлений источника привязки. Gets or sets a value that determines the timing of binding source updates.

ValidatesOnDataErrors ValidatesOnDataErrors ValidatesOnDataErrors ValidatesOnDataErrors

Получает или задает значение, указывающее, включать ли объект DataErrorValidationRule. Gets or sets a value that indicates whether to include the DataErrorValidationRule.

ValidatesOnExceptions ValidatesOnExceptions ValidatesOnExceptions ValidatesOnExceptions

Получает или задает значение, указывающее, включать ли объект ExceptionValidationRule. Gets or sets a value that indicates whether to include the ExceptionValidationRule.

ValidatesOnNotifyDataErrors ValidatesOnNotifyDataErrors ValidatesOnNotifyDataErrors ValidatesOnNotifyDataErrors

Получает или задает значение, указывающее, включать ли объект NotifyDataErrorValidationRule. Gets or sets a value that indicates whether to include the NotifyDataErrorValidationRule.

ValidationRules ValidationRules ValidationRules ValidationRules

Получает коллекцию объектов ValidationRule для данного экземпляра MultiBinding. Gets the collection of ValidationRule objects for this instance of MultiBinding.

Методы

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту. Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию. Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра. Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object. Creates a shallow copy of the current Object.

(Inherited from Object)
ProvideValue(IServiceProvider) ProvideValue(IServiceProvider) ProvideValue(IServiceProvider) ProvideValue(IServiceProvider)

Возвращает объект, который необходимо задать для свойства при применении данной привязки и расширения.Returns an object that should be set on the property where this binding and extension are applied.

(Inherited from BindingBase)
ShouldSerializeBindings() ShouldSerializeBindings() ShouldSerializeBindings() ShouldSerializeBindings()

Определяет необходимость сохранения значения свойства Bindings. Indicates whether the Bindings property should be persisted.

ShouldSerializeFallbackValue() ShouldSerializeFallbackValue() ShouldSerializeFallbackValue() ShouldSerializeFallbackValue()

Возвращает значение, определяющее, должны ли процессы сериализации выполнять сериализацию действующего значения свойства FallbackValue по экземплярам данного класса.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)
ShouldSerializeTargetNullValue() ShouldSerializeTargetNullValue() ShouldSerializeTargetNullValue() ShouldSerializeTargetNullValue()

Возвращает значение, которое указывает, должно ли свойство TargetNullValue быть сериализовано.Returns a value that indicates whether the TargetNullValue property should be serialized.

(Inherited from BindingBase)
ShouldSerializeValidationRules() ShouldSerializeValidationRules() ShouldSerializeValidationRules() ShouldSerializeValidationRules()

Определяет необходимость сохранения значения свойства ValidationRules. Indicates whether the ValidationRules property should be persisted.

ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект. Returns a string that represents the current object.

(Inherited from Object)

Явные реализации интерфейса

IAddChild.AddChild(Object) IAddChild.AddChild(Object) IAddChild.AddChild(Object) IAddChild.AddChild(Object)

Добавляет дочерний объект. Adds a child object.

IAddChild.AddText(String) IAddChild.AddText(String) IAddChild.AddText(String) IAddChild.AddText(String)

Добавляет текстовое содержимое узла в объект. Adds the text content of a node to the object.

Применяется к

См. также