MultiBinding Klasa

Definicja

Opisuje kolekcję obiektów Binding dołączonych do pojedynczej właściwości docelowej powiązania.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
Dziedziczenie
Atrybuty
Implementuje

Uwagi

W obiekcie MultiBinding można określić wiele powiązań.You can specify multiple bindings in a MultiBinding object. Gdy używasz obiektu MultiBinding z konwerterem, tworzy ostateczną wartość dla celu powiązania na podstawie wartości tych powiązań.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. Na przykład kolor może być obliczany na podstawie wartości czerwony, niebieski i zielony, które mogą być wartościami z tego samego lub różnych obiektów źródłowych powiązań.For example, color might be computed from red, blue, and green values, which can be values from the same or different binding source objects. Gdy wartość jest przenoszona z elementu docelowego do źródeł, wartość właściwości docelowej jest tłumaczona na zbiór wartości, które są przekazywane z powrotem do powiązań.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.

Wartości Mode i UpdateSourceTrigger właściwości określają funkcjonalność MultiBinding i są używane jako wartości domyślne dla wszystkich powiązań w kolekcji, chyba że poszczególne powiązania zastępują te właściwości.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. Na przykład, jeśli właściwość Mode w obiekcie MultiBinding jest ustawiona na TwoWay, wszystkie powiązania w kolekcji są uznawane za TwoWay, chyba że ustawisz inną wartość Mode dla jednego ze powiązań jawnie.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. Aby uzyskać więcej informacji, zobacz Właściwości Binding.Mode i Binding.UpdateSourceTrigger.For more information, see the Binding.Mode and Binding.UpdateSourceTrigger properties.

MultiBinding obecnie obsługuje tylko obiekty typu Binding, a nie MultiBinding lub PriorityBinding.MultiBinding currently supports only objects of type Binding and not MultiBinding or PriorityBinding.

Konstruktory

MultiBinding()

Inicjuje nowe wystąpienie klasy MultiBinding klasy.Initializes a new instance of the MultiBinding class.

Właściwości

BindingGroupName

Pobiera lub ustawia nazwę BindingGroup, do którego należy to powiązanie.Gets or sets the name of the BindingGroup to which this binding belongs.

(Odziedziczone po BindingBase)
Bindings

Pobiera kolekcję Binding obiektów w ramach tego wystąpienia MultiBinding.Gets the collection of Binding objects within this MultiBinding instance.

Converter

Pobiera lub ustawia konwerter, który ma zostać użyty do konwersji wartości źródłowych na lub z wartości docelowej.Gets or sets the converter to use to convert the source values to or from the target value.

ConverterCulture

Pobiera lub ustawia obiekt CultureInfo, który odnosi się do dowolnego konwertera przypisanego do powiązań opakowanych MultiBinding lub MultiBinding samego siebie.Gets or sets the CultureInfo object that applies to any converter assigned to bindings wrapped by the MultiBinding or on the MultiBinding itself.

ConverterParameter

Pobiera lub ustawia opcjonalny parametr do przekazania do konwertera jako dodatkowe informacje.Gets or sets an optional parameter to pass to a converter as additional information.

Delay

Pobiera lub ustawia czas oczekiwania (w milisekundach) przed zaktualizowaniem źródła powiązania po zmianie wartości docelowej.Gets or sets the amount of time, in milliseconds, to wait before updating the binding source after the value on the target changes.

(Odziedziczone po BindingBase)
FallbackValue

Pobiera lub ustawia wartość, która ma być używana, gdy powiązanie nie może zwrócić wartości.Gets or sets the value to use when the binding is unable to return a value.

(Odziedziczone po BindingBase)
Mode

Pobiera lub ustawia wartość wskazującą kierunek przepływu danych tego powiązania.Gets or sets a value that indicates the direction of the data flow of this binding.

NotifyOnSourceUpdated

Pobiera lub ustawia wartość wskazującą, czy zdarzenie SourceUpdated ma zostać zgłoszone po przeniesieniu wartości z celu powiązania do źródła powiązania.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

Pobiera lub ustawia wartość wskazującą, czy zdarzenie TargetUpdated ma zostać zgłoszone po przeniesieniu wartości ze źródła powiązania do celu powiązania.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

Pobiera lub ustawia wartość wskazującą, czy podnieść Error dołączonego zdarzenia w elemencie powiązania.Gets or sets a value that indicates whether to raise the Error attached event on the bound element.

StringFormat

Pobiera lub ustawia ciąg określający sposób formatowania powiązania w przypadku wyświetlenia wartości powiązanej jako ciągu.Gets or sets a string that specifies how to format the binding if it displays the bound value as a string.

(Odziedziczone po BindingBase)
TargetNullValue

Pobiera lub ustawia wartość używaną w elemencie docelowym, gdy wartość źródła jest null.Gets or sets the value that is used in the target when the value of the source is null.

(Odziedziczone po BindingBase)
UpdateSourceExceptionFilter

Pobiera lub ustawia procedurę obsługi, której można użyć, aby zapewnić niestandardową logikę obsługi wyjątków, które napotyka aparat powiązań podczas aktualizacji wartości źródłowej powiązania.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. Ma to zastosowanie tylko wtedy, gdy masz skojarzone ExceptionValidationRule z obiektem MultiBinding.This is only applicable if you have associated the ExceptionValidationRule with your MultiBinding object.

UpdateSourceTrigger

Pobiera lub ustawia wartość określającą chronometraż aktualizacji źródła powiązań.Gets or sets a value that determines the timing of binding source updates.

ValidatesOnDataErrors

Pobiera lub ustawia wartość wskazującą, czy dołączać DataErrorValidationRule.Gets or sets a value that indicates whether to include the DataErrorValidationRule.

ValidatesOnExceptions

Pobiera lub ustawia wartość wskazującą, czy dołączać ExceptionValidationRule.Gets or sets a value that indicates whether to include the ExceptionValidationRule.

ValidatesOnNotifyDataErrors

Pobiera lub ustawia wartość wskazującą, czy dołączać NotifyDataErrorValidationRule.Gets or sets a value that indicates whether to include the NotifyDataErrorValidationRule.

ValidationRules

Pobiera kolekcję obiektów ValidationRule dla tego wystąpienia MultiBinding.Gets the collection of ValidationRule objects for this instance of MultiBinding.

Metody

Equals(Object)

Określa, czy określony obiekt jest równy bieżącemu obiektowi.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetType()

Pobiera Type bieżącego wystąpienia.Gets the Type of the current instance.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy skróconą kopię bieżącego Object.Creates a shallow copy of the current Object.

(Odziedziczone po Object)
ProvideValue(IServiceProvider)

Zwraca obiekt, który powinien być ustawiony we właściwości, w której są stosowane to powiązanie i rozszerzenie.Returns an object that should be set on the property where this binding and extension are applied.

(Odziedziczone po BindingBase)
ShouldSerializeBindings()

Wskazuje, czy właściwość Bindings powinna być utrwalona.Indicates whether the Bindings property should be persisted.

ShouldSerializeFallbackValue()

Zwraca wartość wskazującą, czy procesy serializacji powinny serializować wartość efektywną właściwości FallbackValue w wystąpieniach tej klasy.Returns a value that indicates whether serialization processes should serialize the effective value of the FallbackValue property on instances of this class.

(Odziedziczone po BindingBase)
ShouldSerializeTargetNullValue()

Zwraca wartość wskazującą, czy właściwość TargetNullValue powinna być serializowana.Returns a value that indicates whether the TargetNullValue property should be serialized.

(Odziedziczone po BindingBase)
ShouldSerializeValidationRules()

Wskazuje, czy właściwość ValidationRules powinna być utrwalona.Indicates whether the ValidationRules property should be persisted.

ToString()

Zwraca ciąg, który reprezentuje bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)

Jawne implementacje interfejsu

IAddChild.AddChild(Object)

Dodaje obiekt podrzędny.Adds a child object.

IAddChild.AddText(String)

Dodaje zawartość tekstową węzła do obiektu.Adds the text content of a node to the object.

Dotyczy

Zobacz też