DataContextChangedEventArgs Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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à
- 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 . |