DependencyObject.OnPropertyChanged(DependencyPropertyChangedEventArgs) Methode
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.
Wird immer aufgerufen, wenn der effektive Wert einer Abhängigkeitseigenschaft für diese DependencyObject Eigenschaft aktualisiert wurde. Die spezifische Abhängigkeitseigenschaft, die geändert wurde, wird in den Ereignisdaten gemeldet.
protected:
virtual void OnPropertyChanged(System::Windows::DependencyPropertyChangedEventArgs e);protected virtual void OnPropertyChanged(System.Windows.DependencyPropertyChangedEventArgs e);abstract member OnPropertyChanged : System.Windows.DependencyPropertyChangedEventArgs -> unit
override this.OnPropertyChanged : System.Windows.DependencyPropertyChangedEventArgs -> unitProtected Overridable Sub OnPropertyChanged (e As DependencyPropertyChangedEventArgs)Parameter
Ereignisdaten, die den interessanten Bezeichner der Abhängigkeitseigenschaft, die Eigenschaftenmetadaten für den Typ sowie alte und neue Werte enthalten.
Hinweise
Diese Methode dient nicht dazu, einzelne Eigenschaftsänderungen zu erkennen oder Eigenschaften auf Fallbasis ungültig zu machen. OnPropertyChanged ist stattdessen für Änderungen des allgemeinen Ungültigkeitsmusters vorgesehen, wenn bestimmte Informationen über breite Klassifizierungen von Eigenschaften bekannt sind. Beispielsweise können Änderungen in einer Freezable Änderung in den Werttypen der FreezableOder untereigenschaften sein, bei denen sich die Änderungen in anderen Freezable Verweisen befinden. Die Freezable Außerkraftsetzungsimplementierung OnPropertyChanged verwendet interne Informationen, um zu bestimmen, ob die Eigenschaften Untergeordnete Eigenschaften sind, und stellt entsprechende Basisklassenlogik für beide Fälle bereit.
OnPropertyChanged wird während der Lebensdauer eines Objekts möglicherweise mehrmals aufgerufen. Daher können Sie eine bessere Leistung für das gesamte Eigenschaftensystem erzielen, wenn Sie die Metadaten bestimmter Eigenschaften außer Kraft setzen und dann einzelne Eigenschaften anfügen oder CoerceValueCallback Funktionen anfügenPropertyChangedCallback. Sie würden diese Methode jedoch verwenden, wenn eine DependencyObject erhebliche Anzahl von wertübergreifenden Abhängigkeitseigenschaften enthält, oder wenn sie Logik wie das Renderingverhalten enthält, das für mehrere verwandte Fälle von Eigenschaftsinaktivierungen erneut ausgeführt werden muss.
Hinweise für Vererber
Rufen Sie immer die Basisimplementierung auf. Wenn dies nicht der Fall ist, wird das gesamte WPF Eigenschaftensystem erheblich deaktiviert, wodurch falsche Werte gemeldet werden.
