PriorityBinding Klasse

Referenz

Definition

Namespace:: System.Windows.Data

Assembly:: PresentationFramework.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Beschreibt die einer einzelnen Bindungszieleigenschaft zugeordnete Auflistung von Binding-Objekten. Sie erhält ihren Wert von der ersten Bindung in der Auflistung, die erfolgreich einen Wert erstellt.

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

[<System.Windows.Markup.ContentProperty("Bindings")>]
type PriorityBinding = class
    inherit BindingBase
    interface IAddChild

Public Class PriorityBinding
Inherits BindingBase
Implements IAddChild

Vererbung: Object

MarkupExtension

BindingBase
PriorityBinding

Attribute: ContentPropertyAttribute

Implementiert: IAddChild

Hinweise

PriorityBinding ermöglicht es Ihnen, eine Bindungszieleigenschaft (Zieleigenschaft) einer Liste von Bindungen zuzuordnen. Die erste Bindung, die einen Wert zurückgibt, wird erfolgreich zur aktiven Bindung.

Eine Bindung gibt einen Wert erfolgreich zurück, wenn:

Der Pfad zur Bindungsquelle wird erfolgreich aufgelöst.
Der Wertkonverter kann, falls vorhanden, den resultierenden Wert konvertieren.
Der resultierende Wert ist für die Zieleigenschaft gültig.

Der Wert DependencyProperty.UnsetValue wird nicht als erfolgreicher Rückgabewert betrachtet.

Die Priorität der Bindungen wird durch ihre Reihenfolge in der Liste bestimmt. Die Bindung, die zuerst in der Liste angezeigt wird, hat die höchste Priorität.

Das Bindungsmodul beginnt mit der ersten Bindung in der Liste und überprüft, ob diese Bindung einen Wert erfolgreich zurückgibt. wenn dies der Fall ist, wird der Wert aus dieser Bindung verwendet. Wenn die erste Bindung keinen Wert erfolgreich zurückgibt, untersucht das Bindungsmodul die zweite Bindung, um zu ermitteln, ob sie einen Wert erfolgreich zurückgibt. wenn dies der Fall ist, wird der Wert aus der zweiten Bindung zum aktiven Wert. Dieser Überprüfungsprozess wird bis zum Ende der Liste der Bindungen fortgesetzt. Wenn keine der Bindungen einen Wert erfolgreich zurückgibt, verwendet die Bindung den FallbackValue.

Die Bindungs-Engine lauscht weiterhin auf Änderungen an allen Bindungen. Wenn eine der Bindungen mit einer höheren Priorität einen Wert erfolgreich zurückgibt, wird der Wert für diese Bindung zum aktiven Wert und ersetzt den aktuellen Wert.

Konstruktoren

PriorityBinding()

Initialisiert eine neue Instanz der PriorityBinding-Klasse.

Eigenschaften

BindingGroupName	Ruft den Namen der BindingGroup ab, zu der diese Bindung gehört, oder legt diesen fest. (Geerbt von BindingBase)
Bindings	Ruft die Auflistung von Binding-Objekten ab, die für diese Instanz von PriorityBinding erstellt wird.
Delay	Ruft die Zeitdauer in Millisekunden ab, die gewartet wird, ehe die Bindungsquelle aktualisiert wird, nachdem sich der Wert im Ziel geändert hat, oder legt diese fest. (Geerbt von BindingBase)
FallbackValue	Ruft den Wert ab, der verwendet werden soll, wenn die Bindung keinen Wert zurückgeben kann, oder legt diesen fest. (Geerbt von BindingBase)
StringFormat	Ruft eine Zeichenfolge ab, die angibt, wie die Bindung formatiert werden soll, wenn diese den gebundenen Wert als Zeichenfolge anzeigt, oder legt diese fest. (Geerbt von BindingBase)
TargetNullValue	Ruft den Wert ab, der im Ziel verwendet wird, wenn der Wert der Quelle `null` ist, oder legt diesen fest. (Geerbt von BindingBase)

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ProvideValue(IServiceProvider)	Gibt ein Objekt zurück, das auf die Eigenschaft festgelegt werden soll, auf die diese Bindung und Erweiterung angewendet werden. (Geerbt von BindingBase)
ShouldSerializeBindings()	Gibt einen Wert zurück, mit dem angegeben wird, ob Serialisierungsprozesse den tatsächlichen Wert der Bindings-Eigenschaft für Instanzen dieser Klasse serialisieren sollen.
ShouldSerializeFallbackValue()	Gibt einen Wert zurück, mit dem angegeben wird, ob Serialisierungsprozesse den tatsächlichen Wert der FallbackValue-Eigenschaft für Instanzen dieser Klasse serialisieren sollen. (Geerbt von BindingBase)
ShouldSerializeTargetNullValue()	Gibt einen Wert zurück, der angibt, ob die TargetNullValue-Eigenschaft serialisiert werden soll. (Geerbt von BindingBase)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

IAddChild.AddChild(Object)	Dieses Member unterstützt die WPF-Infrastruktur (Windows Presentation Foundation) und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen.
IAddChild.AddText(String)	Dieses Member unterstützt die WPF-Infrastruktur (Windows Presentation Foundation) und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen.

Gilt für: