DataContextChangedEventArgs Classe

Definição

Namespace:

Microsoft.UI.Xaml

Fornece dados para o evento 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

Herança

Object Platform::Object IInspectable DataContextChangedEventArgs

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Comentários

A propriedade FrameworkElement.DataContext tem um comportamento interno pelo qual seu valor herda para todos os elementos filho FrameworkElement de um FrameworkElement em que um valor DataContext é definido. Esse comportamento permite que um conjunto de elementos relacionados use o mesmo contexto para associar a propriedades de origem diferentes, o que é particularmente útil para modelos de item, modelos de dados e outros cenários de associação de dados. Como DataContext herda, há potencial para cada FrameworkElement que usa o valor herdado para disparar outro evento DataContextChanged . Esse evento é originado do elemento herdado, não do elemento pai, depois que o elemento detecta que seu valor DataContext herdado foi alterado. Se você não quiser esse comportamento, deverá manipular o evento DataContextChanged na fonte pai, em que o evento ocorrerá primeiro. Como parte da lógica do manipulador, defina o valor da propriedade Handled nos dados do DataContextChangedEventArgs evento como true. Essa ação impedirá o roteamento do evento para elementos filho.

Observação

DataContextChanged tem comportamento de roteamento, mas não é um evento roteado verdadeiro (ele não tem um identificador RoutedEvent ). Além disso, ele roteia de pai para filho, enquanto os verdadeiros eventos roteado roteam de filho para pai. Se você estiver familiarizado com Windows Presentation Foundation (WPF), DataContextChanged poderá ser considerado um evento de roteamento de túnel pelas definições de roteamento de eventos do WPF.

Propriedades

Handled	Obtém ou define um valor que influencia se outro evento DataContextChanged deve ser disparado de elementos filho que herdam o valor DataContext e detectam que o valor foi alterado.
NewValue	Obtém o novo valor DataContext para o elemento em que o evento DataContextChanged foi acionado.

Confira também

• DataContextChanged
• DataContext