匯出 (0) 列印
全部展開

FrameworkElement.DataContext 屬性

更新:2007 年 11 月

在項目參與資料繫結時取得或設定項目的資料內容。這是相依性屬性。

命名空間:  System.Windows
組件:  PresentationFramework (在 PresentationFramework.dll 中)
針對 XAML 的 XMLNS: http://schemas.microsoft.com/winfx/xaml/presentation

[LocalizabilityAttribute(LocalizationCategory.NeverLocalize)]
public Object DataContext { get; set; }
/** @property */
/** @attribute LocalizabilityAttribute(LocalizationCategory.NeverLocalize) */
public Object get_DataContext()
/** @property */
/** @attribute LocalizabilityAttribute(LocalizationCategory.NeverLocalize) */
public  void set_DataContext(Object value)

public function get DataContext () : Object
public function set DataContext (value : Object)
<object>
  <object.DataContext>
    <dataContextObject />
  </object.DataContext>
</object>
<object DataContext="bindingUsage"/>
- or -
<object DataContext="{resourceExtension contextResourceKey}"/>
dataContextObject
                    直接內嵌的物件,做為父項目內任何繫結的資料內容。通常,這個物件是 Binding 或另一個 BindingBase 衍生類別。另外,要用於繫結之任何 CLR 物件型別的未經處理資料 (Raw Data) 可放在此處,且在稍後定義實際的繫結。
                bindingUsage
                    評估為適當資料內容的繫結使用方式。如需詳細資訊,請參閱繫結標記延伸。
                resourceExtension
                    下列其中一項:StaticResource 或 DynamicResource。當參考定義為資源中之物件的未經處理資料時,會使用這個使用方式。請參閱 資源概觀。
                contextResourceKey
                    從 ResourceDictionary 內請求之物件的索引鍵識別項。
                

屬性值

型別:System.Object

要當做資料內容使用的物件。

識別項欄位

DataContextProperty

中繼資料屬性設為 true

Inherits

資料內容」(Data Context) 是一種概念,可讓項目從其父項目繼承用於繫結之資料來源,以及繫結的其他特性,例如路徑。

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

這個相依性屬性會繼承屬性值。如果有子項目未透過區域數值或樣式為 DataContext 建立其他值,則屬性系統會將該值設為已指派此值之最接近父項目的 DataContext 值。

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

在 XAML 中,DataContext 最常被設定做為 Binding 宣告。您可以使用屬性 (Property) 項目語法或屬性 (Attribute) 語法。屬性 (Attribute) 語法在此頁面的範例中顯示。您也能使用程式碼設定 DataContext

DataContext 是可繫結的屬性,以促進可能與其他內容繫結的內容案例。不過,如果您繫結至 DataContext,請小心不要建立循環的繫結參考 (請勿將 DataContext 繫結至其本身,這是可以做到的,因為屬性值會繼承 DataContext 屬性的本質)。

下列範例說明資料內容如何作用於繫結中,並提供定義繫結屬性之特定值的詳細資訊。

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


...


</Window.Resources>


...


<DockPanel DataContext="{Binding Source={StaticResource MyList}}">


Windows Vista

.NET Framework 和 .NET Compact Framework 並不支援各種平台的所有版本。如需支援平台版本的相關資訊,請參閱.NET Framework 系統需求

.NET Framework

支援版本:3.5、3.0

社群新增項目

新增
Microsoft 正展開一份線上問卷調查,了解您對於 MSDN 網站的看法。 如果您選擇參加,您離開 MSDN 網站時即會顯示線上問卷調查。

您是否想要參加?
顯示:
© 2014 Microsoft