英語で読む

次の方法で共有

FrameworkElement.DataContext プロパティ

  • リファレンス

定義

名前空間:
System.Windows
アセンブリ:
PresentationFramework.dll

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

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

プロパティ値

Object

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

属性
LocalizabilityAttribute

例

次の例は、データ コンテキストがバインドにどのように作用し、バインドされたプロパティの特定の値を定義する情報を提供するかを示しています。

XAML 
<Window.Resources>
  <src:LeagueList x:Key="MyList" />
XAML 
</Window.Resources>
XAML 
<DockPanel DataContext="{Binding Source={StaticResource MyList}}">

注釈

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

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

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

または、クラスの次のいずれかのプロパティ Binding を使用して、バインディング ソースを明示的に指定できます。

- <xref:System.Windows.Data.Binding.ElementName%2A>.
- <xref:System.Windows.Data.Binding.Source%2A>.
- <xref:System.Windows.Data.Binding.RelativeSource%2A>.

詳細については、「 方法: バインディング ソースを指定する」を参照してください。

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

DataContext は、あるコンテキストが別のコンテキストにバインドされる可能性があるシナリオを容易にするバインド可能なプロパティです。 ただし、バインドする DataContext場合は、循環バインディング参照を作成しないように注意してください (それ自体にバインド DataContext しないでください。これは、プロパティのプロパティ値の継承の性質 DataContext により可能です)。

XAML プロパティ要素の使用

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

XAML 属性の使用方法

XAML 
<object DataContext="bindingUsage"/>

- または -

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

XAML 値

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

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

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

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

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

適用対象

製品 バージョン
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
Windows Desktop 3.0, 3.1, 5, 6, 7