BindingOperations::SetBinding Method (DependencyObject^, DependencyProperty^, BindingBase^)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

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
)

Parameters

target
Type: System.Windows::DependencyObject^

The binding target of the binding.

dp
Type: System.Windows::DependencyProperty^

The target property of the binding.

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.

Exception Condition
ArgumentNullException

The target parameter cannot be null.

ArgumentNullException

The dp parameter cannot be null.

ArgumentNullException

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.

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

.NET Framework
Available since 3.0
Silverlight
Available since 3.0
Windows Phone Silverlight
Available since 7.0
Return to top
Show: