Freigeben über


FrameworkElement.SetBinding(DependencyProperty, BindingBase) Methode

Definition

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

dp
DependencyProperty

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.

Gilt für:

Weitere Informationen