DependencyObject.OnPropertyChanged(DependencyPropertyChangedEventArgs) Methode

Definition

Wird immer dann aufgerufen, wenn der effektive Wert einer Abhängigkeitseigenschaft für dieses DependencyObject aktualisiert wurde. Welche spezifische Abhängigkeitseigenschaft geändert wird, 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 -> unit
Protected Overridable Sub OnPropertyChanged (e As DependencyPropertyChangedEventArgs)

Parameter

e
DependencyPropertyChangedEventArgs

Ereignisdaten, die den betreffenden Bezeichner für eine Abhängigkeitseigenschaft, die Eigenschaftsmetadaten für den Typ sowie die alten und neuen Werte enthalten.

Hinweise

Diese Methode dient nicht dazu, einzelne Eigenschaftsänderungen zu erkennen oder Eigenschaften pro Fall 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 des FreezableTyps oder Untereigenschaften sein, bei denen sich die Änderungen innerhalb anderer Freezable Verweise befinden. Die Außerkraftsetzung der Freezable Implementierung von OnPropertyChanged internen Informationen verwendet interne Informationen, um zu bestimmen, ob die Eigenschaften Untereigenschaften sind, und stellt eine geeignete Basisklassenlogik für beide Fälle bereit.

OnPropertyChanged wird möglicherweise mehrmals während des Lebens eines Objekts aufgerufen. Daher können Sie eine bessere Leistung für das gesamteigenschaftensystem erzielen, wenn Sie die Metadaten bestimmter Eigenschaften außer Kraft setzen und dann einzelne Eigenschaften anfügen oder PropertyChangedCallback funktionen anfügenCoerceValueCallback. 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 Eigenschafts invalidationen erneut ausgeführt werden muss.

Hinweise für Vererber

Rufen Sie immer die Basisimplementierung auf. Das gesamte WPF-Eigenschaftssystem wird dadurch erheblich deaktiviert, wodurch falsche Werte gemeldet werden.

Gilt für:

Siehe auch