FrameworkElement.SetBinding Method (DependencyProperty, BindingBase)

Attaches a binding to this element, based on the provided binding object.

Namespace:  System.Windows
Assembly:  PresentationFramework (in PresentationFramework.dll)

public function SetBinding(
	dp : DependencyProperty, 
	binding : BindingBase
) : BindingExpressionBase
You cannot use methods in XAML.

Parameters

dp
Type: System.Windows.DependencyProperty

Identifies the property where the binding should be established.

binding
Type: System.Windows.Data.BindingBase

Represents the specifics of the data binding.

Return Value

Type: System.Windows.Data.BindingExpressionBase
Records the conditions of the binding. This return value can be useful for error checking.

This method is a convenience method for calling BindingOperations.SetBinding, which passes the current instance as the DependencyObject.

This example shows how to create and set a Binding in code.

The FrameworkElement class and the FrameworkContentElement class both expose a SetBinding method. If you are binding an element that inherit either of those classes, you can call the SetBinding method directly, as in following example. In this example, myDataObject is an instance of MyData class and myBinding is the source Binding object. MyData class is a defined class that contains a string property named MyDataProperty. The following example shows how to bind the text content of mytext, an instance of TextBlock, to MyDataProperty.

No code example is currently available or this language may not be supported.

For the complete code sample, see Creating a Binding in Code Sample.

Alternatively, you can use the SetBinding method of the BindingOperations class. In the following example, myNewBindDef is a Binding object that describes the binding. The binding target is myDateText, an instance of the TextBlock class.

	// myDatetext is a TextBlock object that is the binding target object
        BindingOperations.SetBinding(myDateText, TextBlock.TextProperty, myNewBindDef);
        BindingOperations.SetBinding(myDateText, TextBlock.ForegroundProperty, myNewBindDef);

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft