BindingOperations.SetBinding Methode
Definition
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.
Ordnet eine Bindung einer Zieleigenschaft für ein Zielobjekt zu. Diese Methode ist der Code, der der Verwendung einer {Binding}-Markuperweiterung im XAML-Markup entspricht.
static void SetBinding(DependencyObject const& target, DependencyProperty const& dp, BindingBase const& binding);public static void SetBinding(DependencyObject target, DependencyProperty dp, BindingBase binding);function setBinding(target, dp, binding)Public Shared Sub SetBinding (target As DependencyObject, dp As DependencyProperty, binding As BindingBase)Parameter
- target
- DependencyObject
Das Objekt, das das Ziel der ausgewerteten Bindung sein soll.
Die -Eigenschaft für das zu bindende Ziel, angegeben durch den Bezeichner. Diese Bezeichner sind in der Regel als statische schreibgeschützte Eigenschaften für den Typ verfügbar, der das Zielobjekt definiert, oder einen seiner Basistypen. Sie können auch eine Bindung an angefügte Eigenschaften herstellen. Weitere Informationen finden Sie unter Hinweise.
- binding
- BindingBase
Die Bindung, die der Zieleigenschaft zugewiesen werden soll. Diese Bindung sollte initialisiert werden: Wichtige Bindungseigenschaften wie Path sollten bereits festgelegt werden, bevor sie als Parameter übergeben wird.
Hinweise
Sie können eine Bindung an benutzerdefinierte Abhängigkeitseigenschaften oder benutzerdefinierte angefügte Eigenschaften herstellen. Der Bezeichner, den Sie als dp-Parameter übergeben, muss keine Windows-Runtime definierte Eigenschaft sein.
BindingOperations.SetBinding ist eine statische Hilfsprogrammmethode und führt im Wesentlichen dasselbe wie FrameworkElement.SetBinding aus. Es ist üblicher, FrameworkElement.SetBinding zu verwenden, da es sich um eine instance-Methode handelt. Ein wichtiger Unterschied besteht jedoch darin, dass BindingOperations.SetBinding einen Zielwert eines beliebigen DependencyObject verwenden kann, während FrameworkElement.SetBinding per Definition nur für ein FrameworkElement-Ziel verwendet werden kann. Dies spielt bei den meisten Windows-Runtime Klassen, die für die XAML-Benutzeroberfläche verwendet werden, in der Regel keine Rolle, da es sich dabei sowieso hauptsächlich um FrameworkElement-Unterklassen handelt. Die Unterscheidung kann jedoch von Bedeutung sein, wenn Sie Bindungen auf Ihre eigenen benutzerdefinierten Klassen abzielen, die von DependencyObject oder UIElement abgeleitet werden.
Hinweis
Durch Aufrufen der SetBinding-Methode und Übergeben eines neuen Binding-Objekts wird nicht notwendigerweise eine vorhandene Bindung entfernt. Stattdessen sollten Sie zuerst die DependencyObject.ClearValue-Methode und dann SetBinding aufrufen.
Bindung an angefügte Eigenschaften
Sie können Datenbindungen für alle angefügten Eigenschaften einfügen, die von einem Zielobjekt unterstützt werden. Technisch gesehen unterstützt ein DependencyObject alle möglichen angefügten Eigenschaften, aber Sie würden in der Regel nur eine Bindung für eine angefügte Eigenschaft festlegen, die für dieses Objekt oder Ihr Szenario relevant ist. Beispielsweise würden Sie eine Bindung für Grid.Row nur dann festlegen, wenn Sie davon ausgehen, dass das Zielelement über ein übergeordnetes Grid-Element verfügt, das diese Informationen verwendet. Geben Sie den Dp-Parameter als Bezeichner der Abhängigkeitseigenschaft an, der in der Besitzerklasse der angefügten Eigenschaft vorhanden ist (für das Grid.Row-Beispiel lautet dieser Bezeichner Grid.RowProperty). Sie finden diesen Bezeichner nicht auf dem Ziel, da es sich um eine angefügte Eigenschaft handelt. Weitere Informationen zu angefügten Eigenschaften finden Sie unter Übersicht über angefügte Eigenschaften.