Freigeben über

TemplateBinding-Markuperweiterung

  • Artikel

Verknüpft den Wert einer Eigenschaft in einer Steuerelementvorlage so, dass er der Wert einer anderen Eigenschaft des Steuerelements mit Vorlagen ist.

Verwendung von XAML-Attributen

<object property="{TemplateBinding sourceProperty}" ... />

Verwendung von XAML-Attributen (für Setter-Eigenschaft in Vorlage oder Formatvorlage)

<Setter Property="propertyName" Value="{TemplateBinding sourceProperty}" ... />

XAML-Werte

Wert Beschreibung
propertyName DependencyProperty.Name der Eigenschaft, der in der Setter-Syntax festgelegt wird.
sourceProperty Eine weitere Abhängigkeitseigenschaft für den auf Vorlagen basierenden Typ, die durch ihren DependencyProperty.Name angegeben wird.

oder

Ein Eigenschaftenname in Punktnotation, der durch einen anderen Typ als den auf Vorlagen basierenden Zieltyp definiert wird. Hierbei handelt es sich eigentlich um einen PropertyPath. Siehe XAML-Syntax von PropertyPath.

Hinweise

Eine TemplateBinding ist die optimierte Form einer Binding für Vorlagenszenarios, die einer mit {Binding RelativeSource={RelativeSource TemplatedParent}, Mode=OneWay} erstellten Binding entspricht. Eine TemplateBinding ist immer eine unidirektionale Bindung, auch wenn die betroffenen Eigenschaften standardmäßig bidirektionale Bindungen sind. Beide beteiligten Eigenschaften müssen Abhängigkeitseigenschaften sein. Um eine bidirektionale Bindung an ein vorlagenbasiertes übergeordnetes Element zu erreichen, verwenden Sie stattdessen die Bindungsanweisung {Binding RelativeSource={RelativeSource TemplatedParent}, Mode=TwoWay, Path=MyDependencyProperty}.

RelativeSource ist eine weitere Markuperweiterung, die gelegentlich in Verbindung mit oder anstelle von TemplateBinding verwendet wird, um eine relative Eigenschaftenbindung in einer Vorlage auszuführen.

Die Beschreibung von Steuerelementvorlagen als Konzept wird hier nicht behandelt; weitere Informationen finden Sie unter Steuerelementstile und -vorlagen.

Attributsyntax ist die am häufigsten verwendete Syntax für diese Markuperweiterung. Das Zeichenfolgentoken, das auf die TemplateBinding-Bezeichnerzeichenfolge folgt, wird als Property-Wert der zugrunde liegenden TemplateBindingExtension-Erweiterungsklasse zugeordnet.

Die Objektelementsyntax ist möglich, wird jedoch nicht angezeigt, da sie keine realistische Anwendung aufweist. TemplateBinding wird verwendet, um Werte mithilfe von ausgewerteten Ausdrücken innerhalb von Settern zu füllen. Die Verwendung der Objektelementsyntax für TemplateBinding zum Füllen der <Setter.Property>-Eigenschaftenelementsyntax ist unnötig ausführlich.

TemplateBinding kann zudem in einer ausführlichen Attributverwendung genutzt werden, die die Property-Eigenschaft als Paar vom Typ „Eigenschaft=Wert“ angibt:

<object property="{TemplateBinding Property=sourceProperty}" ... />

Die ausführliche Verwendung ist häufig hilfreich, wenn für eine Erweiterung mehr als eine Eigenschaft festgelegt werden kann oder wenn bestimmte Eigenschaften optional sind. Da für TemplateBinding nur eine erforderliche Eigenschaft festgelegt werden kann, ist diese ausführliche Verwendung unüblich.

In der WPF-XAML-Prozessorimplementierung wird die Handhabung dieser Markuperweiterung durch die TemplateBindingExtension-Klasse definiert.

TemplateBinding ist eine Markup-Erweiterung. Markuperweiterungen werden in der Regel implementiert, wenn Attributwerte mit Escapezeichen versehen werden müssen, damit diese nicht als literale Werte oder als Handlernamen betrachtet werden. Zudem werden sie implementiert, wenn diese Anforderung eher global und nicht nur durch den Einsatz von Typkonvertern für bestimmte Typen oder Eigenschaften erfüllt werden soll. Alle Markuperweiterungen in XAML verwenden die zeichen { und } in ihrer Attributsyntax. Dies ist die Konvention, mit der ein XAML-Prozessor erkennt, dass eine Markuperweiterung das Attribut verarbeiten muss. Weitere Informationen finden Sie unter Markuperweiterungen und WPF-XAML.

Siehe auch