DataContextChangedEventArgs Classe

Definizione

Fornisce i dati per l'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
Ereditarietà
Object Platform::Object IInspectable DataContextChangedEventArgs
Attributi

Requisiti Windows

Famiglia di dispositivi
Windows 10 (è stato introdotto in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

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 Windows Presentation Foundation (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 .

Si applica a

Vedi anche