Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

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 BindingExpressionBase SetBinding(
	DependencyProperty dp,
	BindingBase binding
)
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.

//make a new source
MyData myDataObject = new MyData(DateTime.Now);      
Binding myBinding = new Binding("MyDataProperty");
myBinding.Source = myDataObject;
myText.SetBinding(TextBlock.TextProperty, myBinding);

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

Community Additions

Show:
© 2017 Microsoft