{Binding} 「マークアップ拡張」

{Binding} マークアップ拡張は、コントロールのプロパティをコードなどのデータ ソースから取得した値にデータバインドするために使用されます。 {Binding} マークアップ拡張は、XAML 読み込み時に Binding クラスのインスタンスに変換されます。 このバインド オブジェクトは、データ ソースのプロパティから値を取得し、コントロールのプロパティにプッシュします。 必要に応じて、データ ソース プロパティの値の変更を観察し、それらの変更に基づいて自身を更新するようにバインディング オブジェクトを構成できます。 また、必要に応じて、コントロール値への変更をソース プロパティにプッシュするように構成することもできます。 データ バインディングのターゲットであるプロパティは、依存関係プロパティである必要があります。 詳細については、「 依存関係プロパティの概要」を参照してください。

{Binding} はローカル値と同じ依存関係プロパティの優先順位を持ち、命令型コードでローカル値を設定すると、マークアップに設定されている {Binding} の効果が削除されます。

XAML 属性の使用方法

<object property="{Binding}" .../>
-or-
<object property="{Binding propertyPath}" .../>
-or-
<object property="{Binding bindingProperties}" .../>
-or-
<object property="{Binding propertyPath, bindingProperties}" .../>

プロパティの経路

Path は、バインド先のプロパティ (ソース プロパティ) を表します。 Path は位置指定パラメーターです。つまり、パラメーター名を明示的に ({Binding Path=EmployeeID}) 使用することも、最初の名前のないパラメーター ({Binding EmployeeID}) として指定することもできます。

Path の型は、「プロパティ パス」という、カスタム型またはフレームワーク型のプロパティやサブプロパティに評価される文字列です。 型には DependencyObject を指定できますが、必要はありません。 プロパティ パスのステップはドット (.) で区切られ、複数の区切り記号を含めることで、連続するサブプロパティを走査できます。 バインドされるオブジェクトを実装するために使用されるプログラミング言語に関係なく、ドット区切り記号を使用します。

たとえば、UI を従業員オブジェクトの名プロパティにバインドするには、プロパティ パスが "Employee.FirstName" である可能性があります。 アイテム コントロールを従業員の依存を含むプロパティにバインドする場合、プロパティ パスは "Employee.Dependents" になり、アイテム コントロールの項目テンプレートが "Dependents" にアイテムを表示する処理を行います。

データ ソースがコレクションの場合、プロパティ パスはコレクション内の項目を位置またはインデックスで指定できます。 たとえば、「Teams[0].Players」の "[]" がコレクション内の最初の項目を示す "0" を囲んでいます。

既存の DependencyObject に対して ElementName バインドを使用する場合は、添付プロパティをプロパティ パスの一部として使用できます。 添付プロパティ名の中間ドットがプロパティ パスのステップと見なされないようにするためには、所有者名で修飾された添付プロパティ名の周りにかっこを付けます。たとえば、(AutomationProperties.Name)のようにします。

プロパティ パスの中間オブジェクトは、実行時表現で PropertyPath オブジェクトとして格納されますが、ほとんどのシナリオでは、コード内で PropertyPath オブジェクトを操作する必要はありません。 通常、XAML を使用して必要なバインディング情報を指定できます。

プロパティ パスの文字列構文、アニメーション機能領域のプロパティ パス、および PropertyPath オブジェクトの構築の詳細については、「 Property-path 構文」を参照してください。

{Binding} で設定できる Binding クラスのプロパティ

マークアップ拡張機能で設定できる Binding の読み取り/書き込みプロパティが複数存在するため、{Binding} は bindingProperties プレースホルダー構文で示されています。 プロパティは、コンマ区切りの propName=値 ペアで任意の順序で設定できます。 一部のプロパティには型変換がない型が必要であるため、 {Binding} 内で入れ子になった独自のマークアップ拡張が必要です。

手記マークアップを {x:Bind} から {Binding} に変換する場合は、Mode プロパティの既定値の違いに注意してください。

Converter、ConverterLanguage、ConverterLanguage はすべて、バインディング ソースからバインディング ターゲット プロパティと互換性のある型または値に値または型を変換するシナリオに関連しています。 詳細と例については、「データ バインディングの詳細な」の「データ変換」セクションを参照してください。

ソース、RelativeSource、および ElementName 、バインド ソースを指定、相互に排他的です。

ヒントパス や ConverterParameterなど、値に一つの波括弧を指定する必要がある場合は、その前にバックスラッシュ（円記号 \{）を付けます。 または、エスケープする必要がある中かっこを含む文字列全体を 2 次引用符セットで囲みます (例: ConverterParameter='{Mix}')。

例示

<!-- binding a UI element to a view model -->    
<Page ... >
    <Page.DataContext>
        <local:BookstoreViewModel/>
    </Page.DataContext>

    <GridView ItemsSource="{Binding BookSkus}" SelectedItem="{Binding SelectedBookSku, Mode=TwoWay}" ... />
</Page>

<!-- binding a UI element to another UI element -->
<Page ... >
    <Page.Resources>
        <local:S2Formatter x:Key="GradeConverter"/>
    </Page.Resources>

    <Slider x:Name="sliderValueConverter" ... />
    <TextBox Text="{Binding Path=Value, ElementName=sliderValueConverter,
        Mode=OneWay,
        Converter={StaticResource GradeConverter}}"/>
</Page>

2 番目の例では、ElementName、Path、Mode、Converter の 4 つの異なるバインディング プロパティを設定します。 この場合、「パス」は、「Binding」プロパティとして明示的に名前が付けられています。 パスは、同じランタイム オブジェクト ツリー内の別のオブジェクトであるデータ バインディング ソース (という名前のsliderValueConverter) に評価されます。

Converter プロパティの値が、{StaticResource} マークアップ拡張別のマークアップ拡張機能を使用するため、ここには 2 つの入れ子になったマークアップ拡張機能の使用法があることに注意してください。 内部の 1 つは最初に評価されるため、リソースが取得されると、バインドで使用できる実用的な IValueConverter (リソース内の local:S2Formatter 要素によってインスタンス化されるカスタム クラス) が存在します。

ツールのサポート

Microsoft Visual Studio の Microsoft IntelliSense では、XAML マークアップ エディターで {Binding} を作成するときに、データ コンテキストのプロパティが表示されます。 "{Binding" と入力するとすぐに、 Path に適したデータ コンテキスト プロパティがドロップダウンに表示されます。 IntelliSense は 、バインディングの他のプロパティにも役立ちます。 これを機能させるには、マークアップ ページにデータ コンテキストまたはデザイン時データ コンテキストセットが必要です。 [定義に移動 ] (F12) は {Binding} でも機能します。 または、データ バインディング ダイアログを使用することもできます。