FrameworkElement.OnPropertyChanged(DependencyPropertyChangedEventArgs) Methode

Definition

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

Wird immer dann aufgerufen, wenn der effektive Wert einer Abhängigkeitseigenschaft für dieses FrameworkElement aktualisiert wurde. Welche spezifische Abhängigkeitseigenschaft geändert wird, wird im Argumentparameter gemeldet. Überschreibt OnPropertyChanged(DependencyPropertyChangedEventArgs).

protected:
 override void OnPropertyChanged(System::Windows::DependencyPropertyChangedEventArgs e);

protected override void OnPropertyChanged (System.Windows.DependencyPropertyChangedEventArgs e);

override this.OnPropertyChanged : System.Windows.DependencyPropertyChangedEventArgs -> unit

Protected Overrides Sub OnPropertyChanged (e As DependencyPropertyChangedEventArgs)

Parameter

e

DependencyPropertyChangedEventArgs

Die Ereignisdaten, die die geänderte Eigenschaft beschreibt, sowie die alten und neuen Werte.

Hinweise

Diese Methode ist nicht für die allgemeine Erkennung von Eigenschaftsänderungen oder Ungültigigkeiten vorgesehen. Es ist stattdessen für Änderungen des allgemeinen Ungültigkeitsmusters vorgesehen, wenn bestimmte Informationen über breite Klassifizierungen von Eigenschaften bekannt sind.

Diese Methode wird möglicherweise während der Lebensdauer eines Objekts mehrmals aufgerufen. Daher können Sie eine bessere Leistung erzielen, wenn Sie die Metadaten bestimmter Eigenschaften überschreiben und dann funktionen für einzelne Eigenschaften anfügenCoerceValueCallback.PropertyChangedCallback Sie würden diese Methode jedoch verwenden, wenn a FrameworkElement eine erhebliche Anzahl von wertverwandten Abhängigkeitseigenschaften enthält, oder wenn es Logik enthält, z. B. das Renderingverhalten, das für mehrere verwandte Fälle von Eigenschaftsinvalidierungen erneut ausgeführt werden muss.

Beachten Sie, dass es eine identisch benannte OnPropertyChanged Methode mit einer anderen Signatur (der Parametertyp ist PropertyChangedEventArgs) gibt, die in einer Reihe von Klassen angezeigt werden kann. Dies OnPropertyChanged wird für Datenobjektbenachrichtigungen verwendet und ist Teil des Vertrags für INotifyPropertyChanged.

Hinweise für Vererber

Rufen Sie immer die Basisimplementierung als ersten Vorgang in Ihrer Implementierung auf. Andernfalls wird das gesamte WPF-Eigenschaftssystem erheblich deaktiviert, wodurch falsche Werte gemeldet werden. Die spezifische FrameworkElement Implementierung ist auch für die Aufrechterhaltung des ordnungsgemäßen Zustands für eine Vielzahl von Eigenschaften verantwortlich, die sich auf die sichtbare Benutzeroberfläche auswirken. Dazu gehört, die visuelle Struktur basierend auf Stiländerungen zu geeigneten Zeiten zu ungültig zu machen.

Weitere Informationen

• OnPropertyChanged(DependencyPropertyChangedEventArgs)
• PropertyChangedCallback