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 prvek vytvořením nového vlastního datového Paragraph objektu, navazováním tohoto objektu jako DataContexta nastavením cesty vazby na vlastnost v něm.

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) s vazbami, které vyhodnocují vlastnosti tohoto objektu. Můžete také nastavit kontext dat na DataSourceProvider objekt.

Tato vlastnost závislosti dědí hodnoty vlastností. Pokud existují podřízené prvky 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 určení zdroje vazby explicitně: ElementName, nebo SourceRelativeSource. Další informace naleznete v tématu Postupy: Určení zdroje vazby.

V XAML DataContext se nejčastěji nastavuje jako Binding deklarace. Můžete použít syntaxi elementu vlastnosti nebo syntaxi atributu. Syntaxe atributu se zobrazuje 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 prvku. Tento objekt je obvykle podtřídou nebo jinou BindingBase podtřídouBinding. Případně se zde dají umístit 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 vyhodnocuje v příslušném kontextu 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

Pole identifikátoru	DataContextProperty
Vlastnosti metadat nastavené na true	Inherits