DataContextChangedEventArgs Classe

Definizione

Spazio dei nomi:

Microsoft.UI.Xaml

Fornisce i dati per l'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

Ereditarietà

Object Platform::Object IInspectable DataContextChangedEventArgs

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute

Commenti

La proprietà FrameworkElement.DataContext ha un comportamento predefinito in base al quale il relativo valore eredita a tutti gli elementi figlio FrameworkElement di un FrameworkElement in cui è impostato un valore DataContext . Questo comportamento consente a un set di elementi correlati di usare lo stesso contesto per l'associazione a proprietà di origine diverse, particolarmente utili per modelli di elementi, modelli di dati e altri scenari di data binding. Poiché DataContext eredita, è possibile che ogni FrameworkElement usi il valore ereditato per generare un altro evento DataContextChanged . Tale evento viene generato dall'elemento che eredita, non dall'elemento padre, dopo che l'elemento rileva che il valore DataContext ereditato è stato modificato. Se non si vuole questo comportamento, è necessario gestire l'evento DataContextChanged nell'origine padre, in cui si verificherà prima l'evento. Come parte della logica del gestore, impostare il valore della proprietà Handled nei dati dell'evento DataContextChangedEventArgs su true. Questa azione impedirà al routing dell'evento agli elementi figlio.

Nota

DataContextChanged ha un comportamento di routing, ma non è un vero evento indirizzato (non ha un identificatore RoutedEvent ). Viene inoltre instradato da padre a figlio, mentre gli eventi indirizzati true vengono indirizzati da figlio a padre. Se si ha familiarità con Windows Presentation Foundation (WPF), DataContextChanged può essere considerato un evento di routing di tunneling dalle definizioni di routing degli eventi WPF.

Proprietà

Handled	Ottiene o imposta un valore che influenza se un altro evento DataContextChanged deve essere generato da elementi figlio che ereditano il valore DataContext e rilevano che il valore è stato modificato.
NewValue	Ottiene il nuovo valore DataContext per l'elemento in cui è stato generato l'evento DataContextChanged .

Vedi anche

• DataContextChanged
• DataContext