Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.
0 out of 1 rated this helpful - Rate this topic

FrameworkElement.SetBinding Method (DependencyProperty, BindingBase)

Attaches a binding to this element, based on the provided binding object.

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

public BindingExpressionBase SetBinding (
	DependencyProperty dp,
	BindingBase binding
)
public BindingExpressionBase SetBinding (
	DependencyProperty dp, 
	BindingBase binding
)
public function SetBinding (
	dp : DependencyProperty, 
	binding : BindingBase
) : BindingExpressionBase
You cannot use methods in XAML.

Parameters

dp

Identifies the property where the binding should be established.

binding

Represents the specifics of the data 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.

This example shows how to create and set a Binding in code.

The FrameworkElement class and the FrameworkContentElement class both expose a SetBinding method. If you are binding an element that inherit either of those classes, you can call the SetBinding method directly, as in following example. In this example, myDataObject is an instance of MyData class and myBinding is the source Binding object. MyData class is a defined class that contains a string property named MyDataProperty. The following example shows how to bind the text content of mytext, an instance of TextBlock, to MyDataProperty.

//make a new source
  MyData myDataObject = new MyData(DateTime.Now);      
  Binding myBinding = new Binding("MyDataProperty");
  myBinding.Source = myDataObject;
  myText.SetBinding(TextBlock.TextProperty, myBinding);

For the complete code sample, see Code-only Binding Sample.

Alternatively, you can use the SetBinding method of the BindingOperations class. In the following example, myNewBindDef is a Binding object that describes the binding. The binding target is myDateText, an instance of the TextBlock class.

// myDatetext is a TextBlock object that is the binding target object
    BindingOperations.SetBinding(myDateText, TextBlock.TextProperty, myNewBindDef);
    BindingOperations.SetBinding(myDateText, TextBlock.ForegroundProperty, myNewBindDef);

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
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

Show:
© 2014 Microsoft. All rights reserved.