FrameworkElement.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

範例

下列範例說明資料內容如何在系結上運作，並提供定義系結屬性特定值的資訊。

<Window.Resources>
  <src:LeagueList x:Key="MyList" />

</Window.Resources>

<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 Attribute Usage

<object DataContext="bindingUsage"/>  

-或-

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

XAML 值

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

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

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

coNtextResourceKey
從 內 ResourceDictionary 要求之物件的索引鍵識別碼。

相依性屬性資訊

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