SetBinding Method (DependencyProperty, String)

FrameworkContentElement.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


Type: System.Windows.DependencyProperty

Identifies the bound property.

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 on a Paragraph element, by creating a new custom data object, establishing that object as DataContext, and setting the binding path to a property within it.

MyData myDataObject = new MyData();
myflowdocument.DataContext = myDataObject;
introParagraph.SetBinding(Paragraph.TagProperty, "CustomData");

.NET Framework
Available since 3.0
Return to top
© 2015 Microsoft