Export (0) Print
Expand All

FrameworkElement.SetBinding Method (DependencyProperty, String)

Attaches a binding to this element, based on the provided source property name as a path qualification to the data source.

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

public BindingExpression SetBinding(
	DependencyProperty dp,
	string path
)

Parameters

dp
Type: System.Windows.DependencyProperty

Identifies the destination property where the binding should be established.

path
Type: System.String

The source property name or the path to the property used for the binding.

Return Value

Type: System.Windows.Data.BindingExpression
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, and creates a new Binding based on the provided path parameter. This signature is more convenient if you are establishing a simple default binding. If you need to specify any binding properties to non-default conditions, or want to use a MultiBinding or PriorityBinding,you should use the SetBinding(DependencyProperty, BindingBase) signature.

The following example sets a binding using a specific path.

myDataObject = new MyData(System.DateTime.Now);
root.DataContext = myDataObject;
myText.SetBinding(TextBlock.TextProperty, "MyDataProperty");

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Show:
© 2015 Microsoft