FrameworkContentElement.DataContext Eigenschap

Definitie

Hiermee wordt de gegevenscontext voor een element opgehaald of ingesteld wanneer het deelneemt aan gegevensbinding.

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

Waarde van eigenschap

Het object dat moet worden gebruikt als gegevenscontext.

Kenmerken

Voorbeelden

In het volgende voorbeeld wordt een binding ingesteld op een Paragraph element door een nieuw aangepast gegevensobject te maken, dat object tot stand te brengen als DataContexten het bindingspad in te stellen op een eigenschap erin.

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

Opmerkingen

Gegevenscontext is een concept waarmee elementen informatie kunnen overnemen van hun bovenliggende elementen over de bindingsbron die wordt gebruikt voor binding, evenals andere kenmerken van de binding, zoals het pad.

Gegevenscontext kan rechtstreeks worden ingesteld op een CLR-object (Common Language Runtime), waarbij de bindingen worden geëvalueerd op eigenschappen van dat object. U kunt de gegevenscontext ook instellen op een DataSourceProvider object.

Deze afhankelijkheidseigenschap neemt eigenschapswaarden over. Als er onderliggende elementen zonder andere waarde DataContext zijn ingesteld via lokale waarden of stijlen, wordt de waarde ingesteld op de DataContext waarde van het dichtstbijzijnde bovenliggende element waaraan deze waarde is toegewezen.

U kunt ook een van de volgende eigenschappen van de Binding klasse gebruiken om de bindingsbron expliciet op te geven: ElementName, Sourceof RelativeSource. Zie Voor meer informatie : Geef de bindingsbron op.

In XAML DataContext wordt meestal ingesteld op als een Binding declaratie. U kunt de syntaxis van het eigenschapselement of de syntaxis van het kenmerk gebruiken. De syntaxis van het kenmerk wordt weergegeven in het voorbeeld op deze pagina. U kunt ook in code instellen DataContext .

Gebruik van XAML-eigenschapselement

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

XAML-kenmerkgebruik

<object DataContext="bindingUsage"/>

– of –

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

XAML-waarden

dataContextObject Een rechtstreeks ingesloten object dat fungeert als gegevenscontext voor bindingen binnen het bovenliggende element. Dit object is doorgaans een Binding of andere BindingBase subklasse. U kunt ook onbewerkte gegevens van elk CLR-objecttype dat is bedoeld voor binding hier plaatsen, waarbij de werkelijke bindingen later worden gedefinieerd.

bindingUsage Een bindingsgebruik dat evalueert naar een geschikte gegevenscontext. Zie Binding Markup Extension voor meer informatie.

resourceExtension Een van de volgende opties: StaticResource, of DynamicResource. Dit gebruik wordt gebruikt bij het verwijzen naar onbewerkte gegevens die zijn gedefinieerd als een object in resources. Zie XAML-resources.

contextResourceKey De sleutel-id voor het object dat wordt aangevraagd vanuit een ResourceDictionary.

Informatie over afhankelijkheidseigenschappen

Onderdeel Value
Id-veld DataContextProperty
Eigenschappen van metagegevens ingesteld op true Inherits

Van toepassing op