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

屬性值

用做為資料內容的物件。

屬性

範例

下列範例會藉由建立新的自訂資料物件、將該物件建立為 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")

備註

資料內容 是一種概念,可讓專案從其父元素繼承用於系結之系結來源的資訊,以及系結的其他特性,例如路徑。

資料內容可以直接設定為 Common Language Runtime (CLR) 物件,並將系結評估為該物件的屬性。 或者,您可以將資料內容設定為 DataSourceProvider 物件。

這個相依性屬性會繼承屬性值。 如果透過本機值或樣式建立的子項目沒有其他值 DataContext ,則屬性系統會將值設定為 DataContext 指派此值之最接近父元素的值。

或者,您可以使用 類別的 Binding 下列其中一個屬性明確指定系結來源: ElementNameSourceRelativeSource 。 如需詳細資訊,請參閱 如何:指定系結來源

在 XAML 中, DataContext 最常設定為 做為 Binding 宣告。 您可以使用屬性專案語法或屬性語法。 屬性語法會顯示在此頁面上的範例中。 您也可以在程式碼中設定 DataContext

XAML 屬性項目用法

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

XAML Attribute Usage

<object DataContext="bindingUsage"/>  

-或-

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

XAML 值

dataCoNtextObject
直接内嵌物件,可作為父元素內任何系結的資料內容。 一般而言,這個物件是 Binding 或其他 BindingBase 子類別。 或者,任何用於系結之 CLR 物件類型的未經處理資料,都可以在這裡放置,並稍後定義實際的系結。

bindingUsage
評估為適當資料內容的系結使用方式。 如需詳細資訊,請參閱Binding 標記延伸模組

resourceExtension
下列其中一項: StaticResource 、 或 DynamicResource 。 參考資源中定義為物件的原始資料時,會使用此用法。 請參閱 XAML 資源

coNtextResourceKey
從 內 ResourceDictionary 要求之物件的金鑰識別碼。

相依性屬性資訊

識別碼欄位 DataContextProperty
中繼資料屬性設定為 true Inherits

適用於