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 Function SetBinding (
	dp As DependencyProperty,
	path As String
) As BindingExpression

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(Date.Now)
root.DataContext = myDataObject
myText.SetBinding(TextBlock.TextProperty, "MyDataProperty")

.NET Framework
Available since 3.0
Return to top
Show: