DataContextChangedEventArgs Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 DataContextChangedEventArgsPublic NotInheritable Class DataContextChangedEventArgs- Herança
- Atributos
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. |