Compartilhar via


DataContextChangedEventArgs Classe

Definição

Fornece dados para o evento 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
Herança
Object Platform::Object IInspectable DataContextChangedEventArgs
Atributos

Requisitos do Windows

Família de dispositivos
Windows 10 (introduzida na 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v1.0)

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 evento DataContextChangedEventArgs 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 Windows Presentation Foundation (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.

Aplica-se a

Confira também