Skip to main content
BindingExpression Class
 

Contains information about a single instance of a Binding.

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

SystemObject
   System.WindowsExpression
     System.Windows.DataBindingExpressionBase
      System.Windows.DataBindingExpression

public sealed class BindingExpression : BindingExpressionBase, 
	IWeakEventListener
public ref class BindingExpression sealed : BindingExpressionBase, 
	IWeakEventListener
[<Sealed>]
type BindingExpression = 
    class
        inherit BindingExpressionBase
        interface IWeakEventListener
    end
Public NotInheritable Class BindingExpression
	Inherits BindingExpressionBase
	Implements IWeakEventListener
NameDescription
System_CAPS_pubproperty

Gets the BindingGroup that this binding expression belongs to.(Inherited from BindingExpressionBase.)

System_CAPS_pubproperty

Gets the binding source object that this BindingExpression uses.

System_CAPS_pubproperty

Gets a value that indicates whether the parent binding has a failed validation rule.(Inherited from BindingExpressionBase.)

System_CAPS_pubproperty

Gets a value that indicates whether the parent binding has a failed validation rule.(Inherited from BindingExpressionBase.)

System_CAPS_pubproperty

Gets or sets a value that indicates whether the target of the binding has a value that has not been written to the source.(Inherited from BindingExpressionBase.)

System_CAPS_pubproperty

Returns the Binding object of the current BindingExpression.

System_CAPS_pubproperty

Gets the BindingBase object from which this BindingExpressionBase object is created.(Inherited from BindingExpressionBase.)

System_CAPS_pubproperty

Gets the binding source object for this BindingExpression.

System_CAPS_pubproperty

Gets the name of the binding source property for this BindingExpression.

System_CAPS_pubproperty

Gets the status of the binding expression.(Inherited from BindingExpressionBase.)

System_CAPS_pubproperty

Gets the element that is the binding target object of this binding expression.(Inherited from BindingExpressionBase.)

System_CAPS_pubproperty

Gets the binding target property of this binding expression.(Inherited from BindingExpressionBase.)

System_CAPS_pubproperty

Gets the ValidationError that caused this instance of BindingExpressionBase to be invalid.(Inherited from BindingExpressionBase.)

System_CAPS_pubproperty

Gets a collection of ValidationError objects that caused this instance of BindingExpressionBase to be invalid.(Inherited from BindingExpressionBase.)

NameDescription
System_CAPS_pubmethod Equals

Determines whether the specified object is equal to the current object.(Inherited from Object.)

System_CAPS_pubmethod GetHashCode

Serves as the default hash function. (Inherited from Object.)

System_CAPS_pubmethod GetType

Gets the Type of the current instance.(Inherited from Object.)

System_CAPS_pubmethod ToString

Returns a string that represents the current object.(Inherited from Object.)

System_CAPS_pubmethod UpdateSource

Sends the current binding target value to the binding source property in TwoWay or OneWayToSource bindings.(Overrides BindingExpressionBaseUpdateSource.)

System_CAPS_pubmethod UpdateTarget

Forces a data transfer from the binding source property to the binding target property.(Overrides BindingExpressionBaseUpdateTarget.)

System_CAPS_pubmethod ValidateWithoutUpdate

Runs any ValidationRule objects on the associated Binding that have the property set to RawProposedValue or ConvertedProposedValue. This method does not update the source.(Inherited from BindingExpressionBase.)

NameDescription
System_CAPS_pubinterface System_CAPS_privmethod IWeakEventListenerReceiveWeakEvent

This member supports the Windows Presentation Foundation (WPF) infrastructure and is not intended to be used directly from your code.

The Binding class is the high-level class for the declaration of a binding. The BindingExpression class is the underlying object that maintains the connection between the binding source and the binding target. A Binding contains all the information that can be shared across several BindingExpression objects. A BindingExpression is an instance expression that cannot be shared and that contains all the instance information about the Binding.

For example, consider the following, where myDataObject is an instance of the MyData class, myBinding is the source Binding object, and MyData class is a defined class that contains a string property named MyDataProperty. This example binds the text content of mytext, which is 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);
Dim data1 As New MyData(DateTime.Now)
Dim binding1 As New Binding("MyDataProperty")
binding1.Source = data1
Me.myText.SetBinding(TextBlock.TextProperty, binding1)

You can use the same myBinding object to create other bindings. For example, you might use the myBinding object to bind the text content of a check box to MyDataProperty. In that scenario, there will be two instances of BindingExpression that share the myBinding object.

You can obtain a BindingExpression object by using the GetBindingExpression method or the GetBindingExpression method on a data-bound object.

.NET Framework
Available since 3.0
Silverlight
Available since 3.0
Windows Phone Silverlight
Available since 7.0

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Return to top