Binding Class

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Defines a binding that connects the properties of binding targets and data sources.

Inheritance Hierarchy

System.Object
  System.Windows.Markup.MarkupExtension
    System.Windows.Data.BindingBase
      System.Windows.Data.Binding

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

Syntax

'Declaration
Public Class Binding _
    Inherits BindingBase _
    Implements ISupportInitialize
public class Binding : BindingBase, ISupportInitialize
<Binding .../>
See Remarks

The Binding type exposes the following members.

Constructors

  Name Description
Public methodSupported by Silverlight for Windows Phone Binding() Initializes a new instance of the Binding class.
Public method Binding(Binding) Initializes a new instance of the Binding class with initial property values copied from the specified Binding.
Public methodSupported by Silverlight for Windows Phone Binding(String) Initializes a new instance of the Binding class with an initial property path for the data source.

Top

Properties

  Name Description
Public propertySupported by Silverlight for Windows Phone BindsDirectlyToSource Gets or sets a value that indicates whether the binding ignores any ICollectionView settings on the data source.
Public propertySupported by Silverlight for Windows Phone Converter Gets or sets the converter object that is called by the binding engine to modify the data as it is passed between the source and target, or vice versa.
Public propertySupported by Silverlight for Windows Phone ConverterCulture Gets or sets the culture to be used by the Converter.
Public propertySupported by Silverlight for Windows Phone ConverterParameter Gets or sets a parameter that can be used in the Converter logic.
Public propertySupported by Silverlight for Windows Phone ElementName Gets or sets the name of the element to use as the binding source object.
Public propertySupported by Silverlight for Windows Phone FallbackValue Gets or sets the value to use when the binding is unable to return a value. (Inherited from BindingBase.)
Public propertySupported by Silverlight for Windows Phone Mode Gets or sets a value that indicates the direction of the data flow in the binding.
Public propertySupported by Silverlight for Windows Phone NotifyOnValidationError Gets or sets a value that indicates whether the BindingValidationError event is raised on validation errors.
Public propertySupported by Silverlight for Windows Phone Path Gets or sets the path to the binding source property.
Public propertySupported by Silverlight for Windows Phone RelativeSource Gets or sets the binding source by specifying its location relative to the position of the binding target.
Public propertySupported by Silverlight for Windows Phone Source Gets or sets the data source for the binding.
Public propertySupported by Silverlight for Windows Phone StringFormat Gets or sets a string that specifies how to format the binding if it displays the bound value as a string. (Inherited from BindingBase.)
Public propertySupported by Silverlight for Windows Phone TargetNullValue Gets or sets the value that is used in the target when the value of the source is nulla null reference (Nothing in Visual Basic). (Inherited from BindingBase.)
Public propertySupported by Silverlight for Windows Phone UpdateSourceTrigger Gets or sets a value that determines the timing of binding source updates for two-way bindings.
Public propertySupported by Silverlight for Windows Phone ValidatesOnDataErrors Gets or sets a value that indicates whether the binding engine will report validation errors from an IDataErrorInfo implementation on the bound data entity.
Public propertySupported by Silverlight for Windows Phone ValidatesOnExceptions Gets or sets a value that indicates whether the binding engine will report exception validation errors.
Public propertySupported by Silverlight for Windows Phone ValidatesOnNotifyDataErrors Gets or sets a value that indicates whether the binding engine will report validation errors from an INotifyDataErrorInfo implementation on the bound data entity.

Top

Methods

  Name Description
Protected methodSupported by Silverlight for Windows Phone CheckSealed Throws an exception if the binding has already been attached to a binding target. (Inherited from BindingBase.)
Public methodSupported by Silverlight for Windows Phone Equals(Object) Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Protected methodSupported by Silverlight for Windows Phone Finalize Allows an object to try to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection. (Inherited from Object.)
Public methodSupported by Silverlight for Windows Phone GetHashCode Serves as a hash function for a particular type. (Inherited from Object.)
Public methodSupported by Silverlight for Windows Phone GetType Gets the Type of the current instance. (Inherited from Object.)
Protected methodSupported by Silverlight for Windows Phone MemberwiseClone Creates a shallow copy of the current Object. (Inherited from Object.)
Public method ProvideValue Returns an object that should be set on the property where this binding and extension are applied. (Inherited from BindingBase.)
Public methodSupported by Silverlight for Windows Phone ToString Returns a string that represents the current object. (Inherited from Object.)

Top

Fields

  Name Description
Public fieldStatic member IsDebuggingEnabled Indicates whether data binding debugging is enabled.

Top

Explicit Interface Implementations

  Name Description
Explicit interface implemetationPrivate methodSupported by Silverlight for Windows Phone ISupportInitialize.BeginInit Signals the object that initialization is starting.
Explicit interface implemetationPrivate methodSupported by Silverlight for Windows Phone ISupportInitialize.EndInit Signals the object that initialization is complete.

Top

Remarks

For XAML attribute usage for properties that can take a Binding, or that can otherwise be set to a data-bound value, see Binding Markup Extension. The Binding markup extension enables you to specify a Binding value as a single attribute string, including setting Binding properties such as Path and Source.

A Binding object connects a dependency property of a FrameworkElement directly to a data object so that updates to the data object are automatically propagated to the property. The Binding class defines the properties of a binding. Each binding must have a target element, target property, and data source, although some values are provided by default if you do not specify them.

To bind to a property or a subproperty on a data object, set the Path property of the Binding object. For more information, see Property Path Syntax.

You can apply an instance of a Binding class to multiple targets. However, you cannot modify the property values of a Binding object after you attach it to a target element.

NoteNote:

Calling the FrameworkElement.SetBinding method and passing in a new Binding object will not necessarily remove an existing binding. Instead, you should use the DependencyObject.ClearValue method.

Examples

The following example code demonstrates how to use this class.

'Create the source string 
Dim s As String = "Hello"

'Create the binding description 
Dim b As New Binding("")
b.Mode = BindingMode.OneTime
b.Source = s

'Attach the binding to the target 
MyText.SetBinding(TextBlock.TextProperty, b)
//Create the source string
string s = "Hello";

//Create the binding description
Binding b = new Binding("");
b.Mode = BindingMode.OneTime;
b.Source = s;

//Attach the binding to the target
MyText.SetBinding(TextBlock.TextProperty, b);

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Thread Safety

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

See Also

Reference

Other Resources