Partage via


DataContextChangedEventArgs Classe

Définition

Fournit des données pour l’événement DataContextChanged .

public ref class DataContextChangedEventArgs sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class DataContextChangedEventArgs final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class DataContextChangedEventArgs final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class DataContextChangedEventArgs
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class DataContextChangedEventArgs
Public NotInheritable Class DataContextChangedEventArgs
Héritage
Object Platform::Object IInspectable DataContextChangedEventArgs
Attributs

Configuration requise pour Windows

Famille d’appareils
Windows 10 (introduit dans 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Remarques

La propriété FrameworkElement.DataContext a un comportement intégré dans lequel sa valeur hérite de tous les éléments enfants FrameworkElement d’un FrameworkElement où une valeur DataContext est définie. Ce comportement permet à un ensemble d’éléments connexes d’utiliser le même contexte pour établir une liaison à différentes propriétés sources, ce qui est particulièrement utile pour les modèles d’élément, les modèles de données et d’autres scénarios de liaison de données. Étant donné que DataContext hérite, il existe un potentiel pour chaque FrameworkElement qui utilise la valeur héritée pour déclencher un autre événement DataContextChanged . Cet événement provient de l’élément hérité, et non de l’élément parent, une fois que l’élément détecte que sa valeur DataContext héritée a changé. Si vous ne souhaitez pas ce comportement, vous devez gérer l’événement DataContextChanged sur la source parente, où l’événement se produira en premier. Dans le cadre de votre logique de gestionnaire, définissez la valeur de la propriété Handled dans les données d’événement DataContextChangedEventArgs sur true. Cette action empêchera le routage de l’événement vers des éléments enfants.

Notes

DataContextChanged a un comportement de routage, mais n’est pas un véritable événement routé (il n’a pas d’identificateur RoutedEvent ). En outre, il achemine du parent à l’enfant tandis que les événements routés vrais routent de l’enfant au parent. Si vous êtes familiarisé avec Windows Presentation Foundation (WPF), DataContextChanged peut être considéré comme un événement de routage de tunneling par les définitions de routage d’événements Windows Presentation Foundation (WPF).

Propriétés

Handled

Obtient ou définit une valeur qui détermine si un autre événement DataContextChanged doit être déclenché à partir d’éléments enfants qui héritent de la valeur DataContext et détectent que la valeur a changé.

NewValue

Obtient la nouvelle valeur DataContext pour l’élément où l’événement DataContextChanged a été déclenché.

S’applique à

Voir aussi