DataContextChangedEventArgs Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Proporciona datos para el 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
- Herencia
- Atributos
Comentarios
La propiedad FrameworkElement.DataContext tiene un comportamiento integrado por el que su valor hereda todos los elementos secundarios FrameworkElement de un frameworkElement donde se establece un valor DataContext . Este comportamiento permite que un conjunto de elementos relacionados use el mismo contexto para enlazar a diferentes propiedades de origen, lo que resulta especialmente útil para plantillas de elementos, plantillas de datos y otros escenarios de enlace de datos. Dado que DataContext hereda, existe la posibilidad de que cada FrameworkElement use el valor heredado para desencadenar otro evento DataContextChanged . Ese evento se origina del elemento heredado, no del elemento primario, una vez que el elemento detecta que su valor DataContext heredado ha cambiado. Si no desea este comportamiento, debe controlar el evento DataContextChanged en el origen primario, donde se producirá primero el evento. Como parte de la lógica del controlador, establezca el valor de la propiedad Handled en los datos true
del DataContextChangedEventArgs
evento en . Esa acción impedirá que el evento se enruta a elementos secundarios.
Nota
DataContextChanged tiene un comportamiento de enrutamiento, pero no es un evento enrutado verdadero (no tiene un identificador RoutedEvent ). Además, se enruta de elementos primarios a secundarios, mientras que los eventos enrutados verdaderos se enrutan de elemento secundario a primario. Si está familiarizado con Windows Presentation Foundation (WPF), DataContextChanged podría considerarse un evento de enrutamiento de tunelización por las definiciones de enrutamiento de eventos de WPF.
Propiedades
Handled |
Obtiene o establece un valor que influye en si se debe desencadenar otro evento DataContextChanged a partir de elementos secundarios que heredan el valor dataContext y detectan que el valor ha cambiado. |
NewValue |
Obtiene el nuevo valor DataContext del elemento donde se desencadenó el evento DataContextChanged . |