DataContextChangedEventArgs 类

定义

命名空间:

Windows.UI.Xaml

为 DataContextChanged 事件提供数据。

public ref class DataContextChangedEventArgs sealed

/// [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)]
public sealed class DataContextChangedEventArgs

Public NotInheritable Class DataContextChangedEventArgs

继承

Object Platform::Object IInspectable DataContextChangedEventArgs

属性

ContractVersionAttribute MarshalingBehaviorAttribute

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

注解

FrameworkElement.DataContext 属性具有内置行为，其中其值将继承到设置了 DataContext 值的 FrameworkElement 的所有 FrameworkElement 子元素。 此行为使一组相关元素能够使用相同的上下文绑定到不同的源属性，这对于项模板、数据模板和其他数据绑定方案特别有用。 由于 DataContext 继承，因此使用继承值的每个 FrameworkElement 都有可能触发另一个 DataContextChanged 事件。 一旦元素检测到其继承的 DataContext 值已更改，该事件就源自继承元素，而不是父元素。 如果不需要此行为，则应处理父源上的 DataContextChanged 事件，其中事件将首先发生。 作为处理程序逻辑的一部分，将 DataContextChangedEventArgs 事件数据中的 Handled 属性的值设置为 true。 此操作将阻止事件路由到子元素。

注意

DataContextChanged 具有路由行为，但不是真正的路由事件， (它没有 RoutedEvent 标识符) 。 此外，它从父级路由到子级，而真正的路由事件从子路由到父级。 如果熟悉 wpf Windows Presentation Foundation () ，则 Windows Presentation Foundation (WPF) 事件路由定义可将 DataContextChanged 视为隧道路由事件。

属性

Handled	获取或设置一个值，该值影响是否应从继承 DataContext 值的子元素触发另一个 DataContextChanged 事件，并检测该值是否已更改。
NewValue	获取触发 DataContextChanged 事件的元素的新 DataContext 值。

另请参阅

• DataContextChanged
• DataContext