SetBinding Method

BindingOperations.SetBinding Method

Creates and associates a new instance of BindingExpressionBase with the specified binding target property.

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

public static BindingExpressionBase SetBinding(
	DependencyObject target,
	DependencyProperty dp,
	BindingBase binding


Type: System.Windows.DependencyObject
The binding target of the binding.
Type: System.Windows.DependencyProperty
The target property of the binding.
Type: System.Windows.Data.BindingBase
The BindingBase object that describes the binding.

Return Value

Type: System.Windows.Data.BindingExpressionBase
The instance of BindingExpressionBase created for and associated with the specified property. The BindingExpressionBase class is the base class of BindingExpression, MultiBindingExpression, and PriorityBindingExpression.


The target parameter cannot be null.


The dp parameter cannot be null.


The binding parameter cannot be null.

This method creates a new instance of a BindingExpressionBase and associates the instance with the given dependency property of the given object. This method is the way to attach a binding to an arbitrary DependencyObject that may not expose its own SetBinding method.

The following example shows how to use this method to set a binding. In this 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);

.NET Framework

Supported in: 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

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

Community Additions

© 2015 Microsoft