DataContextChangedEventArgs Clase

Definición

Proporciona datos para el 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
Herencia
Object Platform::Object IInspectable DataContextChangedEventArgs
Atributos

Requisitos de Windows

Familia de dispositivos
Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Comentarios

La propiedad FrameworkElement.DataContext tiene un comportamiento integrado en el que su valor hereda a todos los elementos secundarios FrameworkElement de un frameworkElement donde se establece un valor DataContext . Este comportamiento permite a un conjunto de elementos relacionados usar 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 deriva 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á el evento primero. Como parte de la lógica del controlador, establezca el valor de la propiedad Handled en los datos del evento DataContextChangedEventArgs en true. 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 primario a secundario, 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 mediante las definiciones de enrutamiento de eventos de Windows Presentation Foundation (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 para el elemento donde se desencadenó el evento DataContextChanged .

Se aplica a

Consulte también