Binding class

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

Inheritance

Object

  DependencyObject

    BindingBase

      Binding

Syntax

Public Class Binding  
    Inherits BindingBase

<Binding .../>

<dependencyobject dependencyproperty="bindingString" />

XAML Values

bindingString

A {Binding} markup extension usage. The {Binding} usage can also include a path, and/or one or more property=value pairs that set properties of Binding through the markup extension's argument parsing behavior. The following properties can be referenced and set through a {Binding} markup extension usage: Converter, ConverterLanguage, ConverterParameter, ElementName, Mode, Path, RelativeSource, Source. For more info on this syntax, including info on the string form of each argument, see Binding markup extension.

Attributes

MarshalingBehaviorAttribute(Agile)

ThreadingAttribute(Both)

VersionAttribute(NTDDI_WIN8)

WebHostHiddenAttribute()

Members

The Binding class has these types of members:

• Constructors
• Methods
• Properties

Constructors

The Binding class has these constructors.

Methods

The Binding class has these methods. It also inherits methods from the Object class.

Properties

The Binding class has these properties.

Remarks

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 that uses data binding. 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 don't specify them.

To bind to a property or a subproperty on a data object, set the Path property of the Binding object. For more info on how to set Path in code or in XAML, see PropertyPath 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.

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

For more info, see Data binding overview.

For more info on 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 property that is the target of a data binding must be a dependency property. For more info, see Dependency properties overview.

Examples

The following code example demonstrates how to create a binding in XAML. For the complete code listing, see the XAML data binding sample.

<StackPanel Margin="5">

  <TextBlock Text="Name:" Style="{StaticResource DescriptionTextStyle}" 
    Margin="5" HorizontalAlignment="Left" VerticalAlignment="Top"/>

  <TextBox Text="{Binding Path=Name, Mode=TwoWay}" 
    Width="350" Margin="5" HorizontalAlignment="Left" VerticalAlignment="Top"/>

  <TextBlock Text="Organization:" Style="{StaticResource DescriptionTextStyle}" 
    Margin="5" HorizontalAlignment="Left" VerticalAlignment="Top"/>

  <!-- You can omit the 'Path=' portion of the binding expression. --> 
  <TextBox Text="{Binding Organization, Mode=TwoWay}" Width="350" 
    Margin="5" HorizontalAlignment="Left" VerticalAlignment="Top"/>

</StackPanel>

The following example code demonstrates how to create a binding in code.

'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)

Requirements

See also

XAML data binding sample

Data binding overview

Dependency properties overview

BindingOperations.SetBinding

Build date: 12/4/2012