DataContextChangedEventArgs Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt Daten für das DataContextChanged-Ereignis bereit .
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 DataContextChangedEventArgsPublic NotInheritable Class DataContextChangedEventArgs- Vererbung
- Attribute
Hinweise
Die FrameworkElement.DataContext-Eigenschaft verfügt über ein integriertes Verhalten, bei dem ihr Wert an alle untergeordneten FrameworkElement-Elemente eines FrameworkElement erbt, bei dem ein DataContext-Wert festgelegt wird. Dieses Verhalten ermöglicht es einer Reihe verwandter Elemente, denselben Kontext zum Binden an verschiedene Quelleigenschaften zu verwenden, was besonders für Elementvorlagen, Datenvorlagen und andere Datenbindungsszenarien nützlich ist. Da DataContext erbt, besteht die Möglichkeit, dass jedes FrameworkElement , das den geerbten Wert verwendet, ein anderes DataContextChanged-Ereignis auslöst. Dieses Ereignis stammt aus dem erbenden Element, nicht aus dem übergeordneten Element, sobald das Element erkennt, dass sich sein geerbter DataContext-Wert geändert hat. Wenn Sie dieses Verhalten nicht möchten, sollten Sie das DataContextChanged-Ereignis für die übergeordnete Quelle behandeln, in der das Ereignis zuerst auftritt. Legen Sie im Rahmen ihrer Handlerlogik den Wert der Handled-Eigenschaft in den DataContextChangedEventArgs Ereignisdaten auf fest true. Diese Aktion verhindert, dass das Ereignis an untergeordnete Elemente weitergeleitet wird.
Hinweis
DataContextChanged weist routingverhalten auf, ist aber kein echtes Routingereignis (es verfügt nicht über einen RoutedEvent-Bezeichner ). Außerdem wird vom übergeordneten zum untergeordneten Element weitergeleitet, während die wahren Routingereignisse von untergeordneten zu übergeordneten Ereignissen weitergeleitet werden. Wenn Sie mit Windows Presentation Foundation (WPF) vertraut sind, kann DataContextChanged von den WPF-Ereignisroutingdefinitionen als Tunnelroutingereignis betrachtet werden.
Eigenschaften
| Handled |
Ruft einen Wert ab, der beeinflusst, ob ein anderes DataContextChanged-Ereignis von untergeordneten Elementen ausgelöst werden soll, die den DataContext-Wert erben und erkennen, dass sich der Wert geändert hat, oder legt diesen fest. |
| NewValue |
Ruft den neuen DataContext-Wert für das Element ab, in dem das DataContextChanged-Ereignis ausgelöst wurde . |