DataContextChangedEventArgs Classe

Définition

Espace de noms:

Microsoft.UI.Xaml

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

public ref class DataContextChangedEventArgs sealed

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class DataContextChangedEventArgs final

[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 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

ContractVersionAttribute MarshalingBehaviorAttribute

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 associés d’utiliser le même contexte pour se lier à 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êche l’événement de router 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 acheminent 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 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 s’est déclenché.

Voir aussi

• DataContextChanged
• DataContext