共用方式為

FrameworkContentElement.DataContext 屬性

  • 參考

定義

命名空間:
System.Windows
組件:
PresentationFramework.dll

取得或設定項目在參與資料繫結時的資料內容。

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

備註

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

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

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

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

在 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

適用於