Binding 类

定义

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Binding : BindingBase

[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class Binding : BindingBase

Public Class Binding
Inherits BindingBase

<Binding .../>
- or -
<dependencyobject dependencyproperty="{Binding bindingArgs}" />

继承

Object IInspectable DependencyObject BindingBase Binding

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

示例

下面的代码示例演示如何在 XAML 中创建绑定。 有关完整的代码列表，请参阅 XAML 数据绑定示例。

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

以下示例代码演示如何在代码中创建绑定。

// 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.
TextBlock MyText = new TextBlock();
MyText.SetBinding(TextBlock.TextProperty, b);

// Create the source string.
String^ s = ref new String(L"Hello");

// Create the binding description.
Binding^ b = ref new Binding();
b->Mode = BindingMode::OneTime;
b->Source = s;

// Attach the binding to the target.
TextBlock^ MyText = ref new TextBlock();
MyText->SetBinding(MyText->TextProperty, b);

注解

{Binding} 标记扩展允许您在 XAML 中将 Binding 值指定为单个属性字符串，包括设置 Binding 属性，例如 Path 和 Source。 有关数据绑定概念的详细信息，请参阅 深入的数据绑定。

Binding 类可能被视为 {Binding} 标记扩展的代码隐藏公开。 如果绑定已应用于目标 () 加载 XAML 时发生，则无法设置 Binding 对象的读写属性来更改绑定在运行时的行为方式。 任何 XAML 定义的绑定都应被视为不可变。 但是，可以使用 FrameworkElement.SetBinding 创建新的 Binding 对象，设置其属性，并在特定 UI 元素目标上建立新绑定。 有关详细信息，请参阅 在代码中创建绑定。

Binding 对象将 FrameworkElement 的依赖属性直接连接到数据对象，以便数据对象的更新自动传播到使用数据绑定的属性。 Binding 类定义绑定的属性。 每个绑定都必须具有目标元素、目标属性和数据源，但如果未指定这些值，则会默认提供一些值。

若要绑定到数据对象的属性或子属性，请设置 Binding 对象的 Path 属性。 有关如何在代码或 XAML 中设置 Path 的详细信息，请参阅 属性路径语法 或 {Binding} 标记扩展。

可以将 Binding 类的实例应用于多个目标。 但是，在将 Binding 对象附加到目标元素后，无法修改该对象的属性值。

有关可采用绑定或可设置为数据绑定值的属性的 XAML 属性用法的详细信息，请参阅 {Binding} 标记扩展。

作为数据绑定目标的属性必须是依赖属性。 有关详细信息，请参阅依赖属性概述。

构造函数

属性

方法

适用于

另请参阅

• <xref:Microsoft.UI.Xaml.Data.BindingOperations.SetBinding(Microsoft.UI.Xaml.DependencyObject%2cMicrosoft.UI.Xaml.DependencyProperty%2cMicrosoft.UI.Xaml.Data.BindingBase)%0a(bindingoperations_setbinding_746099660.md)>
• XAML 数据绑定示例
• 深入了解数据绑定
• 依赖属性概述
• Property-path 语法