FrameworkContentElement.DataContext プロパティ

リファレンス

定義

名前空間:: System.Windows

アセンブリ:: PresentationFramework.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

要素がデータバインディングに含まれている場合に、その要素のデータコンテキストを取得または設定します。

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

プロパティ値

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

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

依存プロパティ情報


識別子フィールド	DataContextProperty
に設定されたメタデータプロパティ `true`	Inherits

適用対象

次の方法で共有