PriorityBinding Klasa

Definicja

Opisuje kolekcję Binding obiektów, która jest dołączona do pojedynczej właściwości docelowej powiązania, która otrzymuje wartość z pierwszego powiązania w kolekcji, która generuje wartość pomyślnie.Describes a collection of Binding objects that is attached to a single binding target property, which receives its value from the first binding in the collection that produces a value successfully.

public ref class PriorityBinding : System::Windows::Data::BindingBase, System::Windows::Markup::IAddChild
[System.Windows.Markup.ContentProperty("Bindings")]
public class PriorityBinding : System.Windows.Data.BindingBase, System.Windows.Markup.IAddChild
type PriorityBinding = class
    inherit BindingBase
    interface IAddChild
Public Class PriorityBinding
Inherits BindingBase
Implements IAddChild
Dziedziczenie
Atrybuty
Implementuje

Uwagi

PriorityBindingumożliwia skojarzenie właściwości celu powiązania (target) z listą powiązań.PriorityBinding lets you associate a binding target (target) property with a list of bindings. Pierwsze powiązanie, które zwraca wartość, zostanie pomyślnie aktywne.The first binding that returns a value successfully becomes the active binding.

Powiązanie zwraca wartość pomyślnie, jeśli:A binding returns a value successfully if:

  1. Ścieżka do źródła powiązania jest rozpoznawana pomyślnie.The path to the binding source resolves successfully.

  2. Konwerter wartości, jeśli istnieje, jest w stanie skonwertować obliczoną wartość.The value converter, if any, is able to convert the resulting value.

  3. Wartość wyników jest prawidłowa dla właściwości target.The resulting value is valid for the target property.

Wartość DependencyProperty.UnsetValue nie jest uważana za pomyślną wartość zwracaną.The value DependencyProperty.UnsetValue is not considered a successful return value.

Priorytet powiązań jest określany na podstawie ich kolejności na liście.The priority of the bindings is determined by their order in the list. Powiązanie, które pojawia się pierwszy na liście, ma najwyższy priorytet.The binding that appears first in the list has the highest priority.

Aparat powiązań rozpoczyna się od pierwszego powiązania na liście i weryfikuje, czy to powiązanie pomyślnie zwraca wartość; Jeśli tak, wartość z tego powiązania jest używana.The binding engine starts with the first binding in the list and verifies whether that binding returns a value successfully; if it does, the value from that binding is used. Jeśli pierwsze powiązanie nie zwraca wartości pomyślnie, aparat powiązań sprawdza drugie powiązanie, aby określić, czy pomyślnie zwraca wartość. Jeśli tak, wartość z drugiego powiązania zostanie uaktywniona.If the first binding does not return a value successfully, the binding engine examines the second binding to determine whether it returns a value successfully; if it does, the value from the second binding becomes the active value. Ten proces weryfikacji jest kontynuowany na końcu listy powiązań.This verification process continues to the end of the list of bindings. Jeśli żadne ze powiązań nie zwróci wartości pomyślnie, powiązanie używa FallbackValue.If none of the bindings returns a value successfully, the binding uses the FallbackValue.

Aparat powiązań kontynuuje nasłuchiwanie zmian we wszystkich powiązaniach.The binding engine continues to listen for changes on all bindings. Jeśli w dowolnym momencie jedno z powiązań o wyższym priorytecie zwróci wartość, wartość dla tego powiązania jest aktywna wartość i zastępuje bieżącą wartość.If at any point one of the bindings that has a higher priority returns a value successfully, the value for that binding becomes the active value and replaces the current value.

Konstruktory

PriorityBinding()

Inicjuje nowe wystąpienie klasy PriorityBinding klasy.Initializes a new instance of the PriorityBinding 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 ustanowioną dla tego PriorityBindingwystąpienia.Gets the collection of Binding objects that is established for this instance of PriorityBinding.

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)
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)

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()

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

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)
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)

Ten element członkowski obsługuje Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) infrastrukturę i nie jest przeznaczony do użycia bezpośrednio w kodzie.This member supports the Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) infrastructure and is not intended to be used directly from your code.

IAddChild.AddText(String)

Ten element członkowski obsługuje Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) infrastrukturę i nie jest przeznaczony do użycia bezpośrednio w kodzie.This member supports the Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) infrastructure and is not intended to be used directly from your code.

Dotyczy

Zobacz też