Binding クラス

定義

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 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(Windows.Foundation.UniversalApiContract), 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

Windows の要件

例

次のコード例は、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);

'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 
Dim MyText As New TextBlock()
MyText.SetBinding(TextBlock.TextProperty, b)

注釈

{Binding} マークアップ拡張機能を使用すると、XAML で Binding 値を 1 つの属性文字列として指定できます。これには、Path や Source などの Binding プロパティの設定も含まれます。 データ バインディングの概念の詳細については、「 データ バインディングの詳細」を参照してください。

Binding クラスは 、{Binding} マークアップ拡張機能の分離コード公開と見なされる場合があります。 バインドがターゲットに既に適用されている場合 (XAML が読み込まれるときに発生します)、Binding オブジェクトの読み取り/書き込みプロパティを設定して、実行時のバインドの動作を変更することはできません。 XAML で定義されたバインディングは変更できないと見なす必要があります。 ただし、 FrameworkElement.SetBinding を使用して、新しい Binding オブジェクトを作成し、そのプロパティを設定し、特定の UI 要素ターゲットに新しいバインドを確立できます。 詳細については、「 コードでのバインドの作成」を参照してください。

Binding オブジェクトは 、FrameworkElement の依存関係プロパティをデータ オブジェクトに直接接続して、データ オブジェクトの更新がデータ バインディングを使用するプロパティに自動的に反映されるようにします。 Binding クラスは、バインドのプロパティを定義します。 各バインディングにはターゲット要素、ターゲット プロパティ、およびデータ ソースが必要ですが、指定しない場合は既定で一部の値が提供されます。

データ オブジェクトのプロパティまたはサブプロパティにバインドするには、Binding オブジェクトの Path プロパティを設定します。 コードまたは XAML で Path を設定する方法の詳細については、「 プロパティ パス構文 」または 「{Binding} マークアップ拡張機能」を参照してください。

Binding クラスのインスタンスを複数のターゲットに適用できます。 ただし、Binding オブジェクトをターゲット要素にアタッチした後でプロパティ値を変更することはできません。

Binding を受け取ることができるプロパティ、またはデータ バインド値に設定できるプロパティの XAML 属性の使用方法の詳細については、「 {Binding} マークアップ拡張」を参照してください。

データ バインディングのターゲットとなるプロパティは、依存関係プロパティである必要があります。 詳しくは、「依存関係プロパティの概要」をご覧ください。

コンストラクター

プロパティ

メソッド

適用対象

こちらもご覧ください

• SetBinding(DependencyObject, DependencyProperty, BindingBase)
• XAML データ バインディングのサンプル
• データ バインディングの詳細
• 依存関係プロパティの概要
• プロパティ パス構文