BindingOperations.SetBinding Methode

Referenz

Definition

Namespace:: Windows.UI.Xaml.Data

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.

Bearbeiten

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.

dp: DependencyProperty

Die Eigenschaft für das zu bindende Ziel, die durch seinen Bezeichner angegeben wird. Diese Bezeichner sind in der Regel als statische schreibgeschützte Eigenschaften für den Typ verfügbar, der das Zielobjekt oder einen seiner Basistypen definiert. Sie können auch an angefügte Eigenschaften binden. 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 werden.

Hinweise

Sie können an benutzerdefinierte Abhängigkeitseigenschaften oder benutzerdefinierte angefügte Eigenschaften binden. 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 Grunde 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 in der Regel keine Rolle für die meisten Windows-Runtime Klassen, die für die XAML-Benutzeroberfläche verwendet werden, da es sich dabei meist 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 Das Aufrufen der SetBinding-Methode und das Übergeben eines neuen Binding-Objekts wird eine vorhandene Bindung nicht unbedingt 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 legen normalerweise nur eine Bindung für eine angefügte Eigenschaft fest, 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 für die Besitzerklasse der angefügten Eigenschaft vorhanden ist (für das Grid.Row-Beispiel ist 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.

Gilt für: