FrameworkContentElement.DataContext プロパティ

public:
 property System::Object ^ DataContext { System::Object ^ get(); void set(System::Object ^ value); };

[System.Windows.Localizability(System.Windows.LocalizationCategory.NeverLocalize)]
public object DataContext { get; set; }

[<System.Windows.Localizability(System.Windows.LocalizationCategory.NeverLocalize)>]
member this.DataContext : obj with get, set

Public Property DataContext As Object

プロパティ値

データ コンテキストとして使用するオブジェクト。

属性

LocalizabilityAttribute

例

次の例では、新しいカスタム データ オブジェクトを作成し、そのオブジェクトをDataContextとして確立し、その中のプロパティにバインド パスを設定することで、Paragraph要素にバインドを設定します。

MyData myDataObject = new MyData();
myflowdocument.DataContext = myDataObject;
introParagraph.SetBinding(Paragraph.TagProperty, "CustomData");

Dim myDataObject As New MyData()
myflowdocument.DataContext = myDataObject
introParagraph.SetBinding(Paragraph.TagProperty, "CustomData")

注釈

データ コンテキスト は、バインディングに使用されるバインディング ソースに関する情報と、バインディングの他の特性 (パスなど) を要素が親要素から継承できるようにする概念です。

データ コンテキストは、共通言語ランタイム (CLR) オブジェクトに直接設定でき、バインドはそのオブジェクトのプロパティに評価されます。 または、データ コンテキストを DataSourceProvider オブジェクトに設定することもできます。

この依存関係プロパティは、プロパティ値を継承します。 ローカル値またはスタイルを使用して確立された DataContext の他の値を持たない子要素がある場合、プロパティ システムは、この値が割り当てられている最も近い親要素の DataContext 値に値を設定します。

または、 Binding クラスのいずれかのプロパティを使用して、バインディング ソースを明示的に指定できます: ElementName、 Source、または RelativeSource。 詳細については、「 方法: バインディング ソースを指定する」を参照してください。

XAML では、 DataContext は最も一般的に Binding 宣言として設定されます。 プロパティ要素の構文または属性構文を使用できます。 このページの例では、属性構文を示します。 コードで DataContext を設定することもできます。

XAML プロパティ要素の使用法

<object>
  <object.DataContext>
    <dataContextObject />
  </object.DataContext>
</object>

XAML 属性の使用法

<object DataContext="bindingUsage"/>

-または-

<object DataContext="{resourceExtension contextResourceKey}"/>

XAML 値

dataContextObject 親要素内のバインディングのデータ コンテキストとして機能する直接埋め込みオブジェクト。 通常、このオブジェクトは Binding または別の BindingBase サブクラスです。 または、バインドを目的とした CLR オブジェクト型の生データを、後で定義した実際のバインディングを使用して、ここに配置することもできます。

bindingUsage 適切なデータ コンテキストに評価されるバインディングの使用法。 詳細については、「 バインディング マークアップ拡張機能」を参照してください。

resourceExtension 次のいずれか: StaticResource、または DynamicResource。 この使用法は、リソース内のオブジェクトとして定義された生データを参照する場合に使用されます。 「XAML リソース」を参照してください。

contextResourceKeyResourceDictionary内から要求されるオブジェクトのキー識別子。

依存関係プロパティ情報