Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

FrameworkElement.DataContext, propriété

Obtient ou définit le contexte de données d’un élément lorsqu’il participe à la liaison de données.

Espace de noms :  System.Windows
Assembly :  PresentationFramework (dans PresentationFramework.dll)
XMLNS pour XAML : http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation

[LocalizabilityAttribute(LocalizationCategory.NeverLocalize)]
public Object DataContext { get; set; }
<object>
  <object.DataContext>
    <dataContextObject />
  </object.DataContext>
</object>
<object DataContext="bindingUsage"/>
- or -
<object DataContext="{resourceExtension contextResourceKey}"/>

Valeurs XAML

dataContextObject

Un objet incorporé directement qui sert de contexte de données pour toutes les liaisons dans l'élément parent. Cet objet est en général Binding ou une autre classe dérivée BindingBase. Les données brutes de tout type d'objet CLR prévues pour la liaison peuvent également être placées ici, avec les liaisons réelles définies ultérieurement.

bindingUsage

Une utilisation de liaison qui évalue à un contexte de données approprié. Pour plus d'informations, consultez Binding, extension de balisage.

resourceExtension

L'une des valeurs suivantes : StaticResource ou DynamicResource. Cette utilisation sert à faire référence aux données brutes définies comme un objet dans les ressources. Consultez Ressources XAML.

contextResourceKey

L'identificateur clé pour l'objet qui est demandé à partir d'un ResourceDictionary.

Valeur de propriété

Type : System.Object
L'objet à utiliser comme contexte de données.

Champ d'identificateur

DataContextProperty

Propriétés de métadonnées définies à true

Inherits

Le contexte de données est un concept qui permet aux éléments d'hériter des informations de leurs éléments parents à propos de la source de liaison utilisée, aussi bien que d'autres caractéristiques de la liaison tel que le chemin d'accès.

Le contexte de données peut être directement défini comme un objet Common Language Runtime (CLR), avec les liaisons qui évaluent aux propriétés de cet objet. Vous pouvez également affecter au contexte de données un objet DataSourceProvider.

Cette propriété de dépendance hérite des valeurs de propriété. S'il existe des éléments enfants sans autre valeur pour DataContext établi par le biais de valeurs locales ou de styles, le système de propriétés définit la valeur comme étant la valeur DataContext de l'élément parent le plus proche avec cette valeur attribuée.

Vous pouvez également utiliser l'une des propriétés suivantes de la classe Binding pour spécifier la source de liaison de manière explicite : ElementName, Source ou RelativeSource. Pour plus d'informations, consultez Comment : spécifier la source de liaison.

En XAML, DataContext est le plus couramment défini comme une déclaration de Binding. Vous pouvez utiliser l'une ou l'autre des syntaxes d'élément de propriété ou d'attribut. La syntaxe d'attribut est affichée dans l'exemple de cette page. Vous pouvez également définir DataContext par du code.

DataContext est une propriété pouvant être liée, faciliter des scénarios où un contexte peut être lié à un autre. Toutefois, si vous créez une liaison avec DataContext, veillez à ne pas créer de références circulaires de liaison (ne liez pas DataContext à lui-même, ce qui reste possible de par la nature d'héritage de la valeur de la propriété DataContext).

L'exemple suivant illustre comment un contexte de données agit sur une liaison et fournit les informations qui définissent les valeurs spécifiques des propriétés liées.


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


...


</Window.Resources>


...


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


.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

.NET pour les applications Windows Phone

Pris en charge dans : Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft