DataContextChangedEventArgs 類別

定義

命名空間:

Microsoft.UI.Xaml

提供 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

繼承

Object Platform::Object IInspectable DataContextChangedEventArgs

屬性

ContractVersionAttribute MarshalingBehaviorAttribute

備註

FrameworkElement.DataCoNtext屬性具有內建行為，其中其值會繼承至設定DataCoNtext值之FrameworkElement 的所有 FrameworkElement子項目。 此行為可讓一組相關元素使用相同的內容來系結至不同的來源屬性，這對專案範本、資料範本和其他資料系結案例特別有用。 由於 DataCoNtext 繼承，因此每個 FrameworkElement 都可能會使用繼承的值來引發另一個 DataCoNtextChanged 事件。 一旦專案偵測到其繼承 的 DataCoNtext 值已變更，該事件就會從繼承的元素而非父元素來源。 如果您不想要此行為，您應該在父來源上處理 DataCoNtextChanged 事件，其中會先發生事件。 作為處理常式邏輯的一部分，將事件資料中 DataContextChangedEventArgsHandled屬性的值設定為 true 。 該動作會防止事件路由傳送至子項目。

注意

DataCoNtextChanged 具有路由行為，但不是真正的路由事件， (它沒有 RoutedEvent 識別碼) 。 此外，它會從父系路由至子系，而真正的路由事件則會從子系路由至父系。 如果您熟悉WINDOWS PRESENTATION FOUNDATION (WPF) ，則 WPF 事件路由定義可能會將DataCoNtextChanged視為通道路由事件。

屬性

Handled	取得或設定值，這個值會影響是否應該從繼承DataCoNtext值的子項目引發另一個DataCoNtextChanged事件，並偵測值已變更。
NewValue	取得引發 DataCoNtextChanged事件之專案的新DataCoNtext值。

另請參閱

• DataContextChanged
• DataContext