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)

'Declaration
Public Function SetBinding ( _
	dp As DependencyProperty, _
	path As String _
) As BindingExpression
'Usage
Dim instance As FrameworkElement
Dim dp As DependencyProperty
Dim path As String
Dim returnValue As BindingExpression

returnValue = instance.SetBinding(dp, path)
public BindingExpression SetBinding (
	DependencyProperty dp, 
	String path
)
public function SetBinding (
	dp : DependencyProperty, 
	path : String
) : BindingExpression
You cannot use methods in XAML.

Parameters

dp

Identifies the destination property where the binding should be established.

path

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

Return Value

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");

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0

Community Additions

ADD
Show: