FrameworkContentElement.DataContext Vlastnost

Definice

Obor názvů:

System.Windows

Sestavení:

PresentationFramework.dll

Získá nebo nastaví kontext dat pro prvek, když se účastní datové vazby.

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

Hodnota vlastnosti

Object

Objekt, který se má použít jako kontext dat.

Atributy

LocalizabilityAttribute

Příklady

Následující příklad nastaví vazbu na Paragraph element vytvořením nového vlastního datového objektu, navazováním tohoto objektu jako DataContexta nastavením cesty vazby na vlastnost uvnitř.

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

Poznámky

Kontext dat je koncept, který umožňuje elementům dědit informace z nadřazených prvků o zdroji vazby, který se používá pro vazbu, a také další vlastnosti vazby, jako je cesta.

Kontext dat lze nastavit přímo na objekt CLR (Common Language Runtime), přičemž vazby vyhodnocují vlastnosti tohoto objektu. Případně můžete nastavit kontext dat na DataSourceProvider objekt.

Tato vlastnost závislosti dědí hodnoty vlastností. Pokud existují podřízené elementy bez jiné hodnoty vytvořené DataContext prostřednictvím místních hodnot nebo stylů, systém vlastností nastaví hodnotu na DataContext hodnotu nejbližšího nadřazeného prvku s touto přiřazenou hodnotou.

Alternativně můžete použít jednu z následujících vlastností Binding třídy k explicitnímu určení zdroje vazby: ElementName, Sourcenebo RelativeSource. Další informace naleznete v tématu Postupy: Určení zdroje vazby.

V jazyce XAML DataContext je nejčastěji nastavená Binding jako deklarace. Můžete použít syntaxi elementu vlastnosti nebo syntaxi atributu. Syntaxe atributu je zobrazena v příkladu na této stránce. Můžete také nastavit DataContext kód.

Použití elementu vlastnosti XAML

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

Použití atributu XAML

<object DataContext="bindingUsage"/>

nebo

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

Hodnoty XAML

dataContextObject Přímo vložený objekt, který slouží jako kontext dat pro všechny vazby v rámci nadřazeného elementu. Tento objekt je obvykle podtřídou nebo jinou Binding podtřídouBindingBase. Případně mohou být zde umístěna nezpracovaná data libovolného typu objektu CLR určeného pro vazbu se skutečnými vazbami definovanými později.

bindingUsage Použití vazby, které se vyhodnotí jako odpovídající kontext dat. Podrobnosti najdete v tématu rozšíření značek vazby.

resourceExtension Jedna z následujících možností: StaticResourcenebo DynamicResource. Toto použití se používá při odkazování na nezpracovaná data definovaná jako objekt v prostředcích. Viz prostředky XAML.

contextResourceKey Identifikátor klíče požadovaného objektu v rámci objektu ResourceDictionary.

Informace o vlastnosti závislosti

Item	Hodnota
Pole Identifikátor	DataContextProperty
Vlastnosti metadat nastavené na true	Inherits