FrameworkElement.SetBinding(DependencyProperty, BindingBase) 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.
Fügt eine Bindung mithilfe des bereitgestellten Bindungsobjekts an ein FrameworkElement an.
void SetBinding(DependencyProperty const& dp, BindingBase const& binding);public void SetBinding(DependencyProperty dp, BindingBase binding);function setBinding(dp, binding)Public Sub SetBinding (dp As DependencyProperty, binding As BindingBase)Parameter
Der Bezeichner der Abhängigkeitseigenschaft der Eigenschaft, die datengebunden ist.
- binding
- BindingBase
Die Bindung, die für die -Eigenschaft verwendet werden soll.
Beispiele
In diesem Beispiel wird eine Bindung an eine Abhängigkeitseigenschaft für ein -Objekt durch Aufrufen von SetBinding eingerichtet.
// Create the source string.
string s = "Hello";
// Create the binding description.
Binding b = new Binding();
b.Mode = BindingMode.OneTime;
b.Source = s;
// Attach the binding to the target.
TextBlock MyText = new TextBlock();
MyText.SetBinding(TextBlock.TextProperty, b);
'Create the source string
Dim s As String = "Hello"
'Create the binding description
Dim b As New Binding()
b.Mode = BindingMode.OneTime
b.Source = s
'Attach the binding to the target
Dim MyText As New TextBlock()
MyText.SetBinding(TextBlock.TextProperty, b)
Hinweise
Diese Methode ist eine bequeme Methode, die BindingOperations.SetBinding aufruft und den aktuellen instance als Zielparameter übergibt.
Der Typ des Bindungsparameters ist aus Kompatibilitätsgründen BindingBase, aber im Windows-Runtime übergeben Sie immer eine Bindungs-instance. Die Bindung wird von BindingBase abgeleitet.
Der dp-Parameter akzeptiert einen Abhängigkeitseigenschaftsbezeichner. Weitere Informationen zu Abhängigkeitseigenschaften und dazu, wie ein DependencyProperty-Wert als Bezeichner fungiert, finden Sie unter Übersicht über Abhängigkeitseigenschaften.
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.
Ob eine aus Code erstellte Bindung einen handelnden Datenkontext verwenden kann, hängt von den Überlegungen zur Objektlebensdauer ab. Beispielsweise ist ein DataContext-Wert , der von XAML festgelegt wird, erst verfügbar, wenn der XAML-Code analysiert wurde. In diesem Fall können Sie einen Loaded-Handler verwenden, um Bindungen aus Code hinzuzufügen.
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.