FrameworkContentElement.DataContext FrameworkContentElement.DataContext FrameworkContentElement.DataContext FrameworkContentElement.DataContext Property

定義

要素がデータ バインディングに含まれている場合に、その要素のデータ コンテキストを取得または設定します。Gets or sets the data context for an element when it participates in data binding.

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; }
member this.DataContext : obj with get, set
Public Property DataContext As Object

プロパティ値

データ コンテキストとして使用するオブジェクト。The object to use as data context.

次の例でバインディングを設定する、Paragraphとしては、そのオブジェクトを確立する、新しいカスタム データ オブジェクトを作成して、要素DataContext、内のプロパティにバインド パスを設定するとします。The following example sets a binding on a Paragraph element, by creating a new custom data object, establishing that object as DataContext, and setting the binding path to a property within it.

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")

注釈

データ コンテキストは情報をバインディングとバインド パスなどの他の特性のために使用されるバインド ソースについて、親要素から継承できるようにする概念です。Data context is a concept that allows elements to inherit information from their parent elements about the binding source that is used for binding, as well as other characteristics of the binding such as the path.

直接データ コンテキストを設定することができます、共通言語ランタイム (CLR)common language runtime (CLR)そのオブジェクトのプロパティに評価されるバインドでのオブジェクト。Data context can be set directly to a 共通言語ランタイム (CLR)common language runtime (CLR) object, with the bindings evaluating to properties of that object. または、データ コンテキストを設定、DataSourceProviderオブジェクト。Alternatively, you can set the data context to a DataSourceProvider object.

この依存関係プロパティは、プロパティの値を継承します。This dependency property inherits property values. その他の値のない子要素があるかどうかはDataContextローカル値またはスタイルを通じて確立されると、プロパティ システムはある値を設定は、DataContext最も近い親要素の値をこの値が割り当てられています。If there are child elements with no other value for DataContext established through local values or styles, the property system will set the value to be the DataContext value of the nearest parent element with this value assigned.

次のプロパティのいずれかを使用する代わりに、Bindingバインディング ソースを明示的に指定するクラス。 ElementNameSource、またはRelativeSourceします。Alternatively, you can use one of the following properties of the Binding class to specify the binding source explicitly: ElementName, Source, or RelativeSource. 詳細については、「方法 :バインディング ソースを指定します。For more information, see How to: Specify the Binding Source.

XAMLXAMLDataContextとして最も一般的に設定されて、Binding宣言します。In XAMLXAML, DataContext is most commonly set to as a Binding declaration. プロパティ要素構文または属性の構文を使用することができます。You can use either property element syntax or attribute syntax. 属性構文は、このページの例に示します。Attribute syntax is shown in the example on this page. 設定することもDataContextコード。You can also set DataContext in code.

XAML プロパティ要素の使用XAML Property Element Usage

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

XAML 属性の使用方法XAML Attribute Usage

<object DataContext="bindingUsage"/>  
- or -  
<object DataContext="{resourceExtension contextResourceKey}"/>  

XAML 値XAML Values

dataContextObjectdataContextObject
親要素内のすべてのバインディングのデータ コンテキストとして機能する直接埋め込まれたオブジェクト。A directly embedded object that serves as data context for any bindings within the parent element. 通常、このオブジェクトは、Binding別またはBindingBaseサブクラスです。Typically, this object is a Binding or another BindingBase subclass. または、いずれかの生データCLRCLRオブジェクトの種類を後で定義されている実際のバインディングとバインドはここでは、配置できます対象としています。Alternatively, raw data of any CLRCLR object type intended for binding may be placed here, with the actual bindings defined later.

bindingUsagebindingUsage
バインディングの使用方法、適切なデータ コンテキストに評価されます。A binding usage that evaluates to an appropriate data context. 詳細については、「バインディングのマークアップ拡張機能」を参照してください。For details, see Binding Markup Extension.

resourceExtensionresourceExtension
次のいずれか: StaticResource、またはDynamicResourceします。One of the following: StaticResource, or DynamicResource. この使用法は、リソース内のオブジェクトとして定義されている生データを参照するときに使用されます。This usage is used when referring to raw data defined as an object in resources. 参照してくださいXAML リソースします。See XAML Resources.

contextResourceKeycontextResourceKey
内から要求されているオブジェクトのキー識別子、ResourceDictionaryします。The key identifier for the object being requested from within a ResourceDictionary.

依存プロパティ情報Dependency Property Information

識別子フィールドです。Identifier field DataContextProperty
メタデータのプロパティを設定するには trueMetadata properties set to true Inherits

適用対象