FrameworkContentElement.DataContext Propriété

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

Valeur de propriété

Objet à utiliser comme contexte de données.

Attributs

LocalizabilityAttribute

Exemples

L’exemple suivant définit une liaison sur un Paragraph élément, en créant un objet de données personnalisé, en établissant cet objet et DataContexten définissant le chemin de liaison sur une propriété dans celle-ci.

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

Remarques

Le contexte de données est un concept qui permet aux éléments d’hériter des informations de leurs éléments parents sur la source de liaison utilisée pour la liaison, ainsi que d’autres caractéristiques de la liaison, telles que le chemin d’accès.

Le contexte de données peut être défini directement sur un objet CLR (Common Language Runtime), avec les liaisons évaluant les propriétés de cet objet. Vous pouvez également définir le contexte de données sur un DataSourceProvider objet.

Cette propriété de dépendance hérite des valeurs de propriété. S’il n’existe aucun autre élément enfant pour DataContext établi par le biais de valeurs ou de styles locaux, le système de propriétés définit la valeur comme DataContext valeur de l’élément parent le plus proche avec cette valeur affectée.

Vous pouvez également utiliser l’une des propriétés suivantes de la Binding classe pour spécifier explicitement la source de liaison : ElementName, Sourceou RelativeSource. Pour plus d’informations, consultez Guide pratique pour spécifier la source de liaison.

En XAML, DataContext est le plus souvent défini sur une Binding déclaration. Vous pouvez utiliser la syntaxe de l’élément de propriété ou la syntaxe d’attribut. La syntaxe d’attribut est affichée dans l’exemple de cette page. Vous pouvez également définir DataContext dans le code.

Utilisation de l’élément de propriété XAML

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

Utilisation des attributs XAML

<object DataContext="bindingUsage"/>

- ou -

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

Valeurs XAML

dataContextObject Objet directement incorporé qui sert de contexte de données pour toutes les liaisons dans l’élément parent. En règle générale, cet objet est une Binding ou une autre BindingBase sous-classe. Vous pouvez également placer ici des données brutes d’un type d’objet CLR destiné à la liaison, avec les liaisons réelles définies ultérieurement.

bindingUsage Utilisation de liaison qui prend la valeur d’un contexte de données approprié. Pour plus d’informations, consultez Extension de balisage Liaison.

resourceExtension L’un des éléments suivants : StaticResourceou DynamicResource. Cette utilisation est utilisée lors de la référence aux données brutes définies en tant qu’objet dans les ressources. Consultez les ressources XAML.

contextResourceKey Identificateur de clé de l’objet demandé à partir d’un ResourceDictionary.

Informations sur les propriétés de dépendance