DataContextChangedEventArgs Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 DataContextChangedEventArgsPublic NotInheritable Class DataContextChangedEventArgs- Héritage
- 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é. |