FrameworkElement.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 FrameworkElement Eigenschaft aktualisiert wurde. Die spezifische Abhängigkeitseigenschaft, die geändert wurde, 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 -> unitProtected Overrides Sub OnPropertyChanged (e As DependencyPropertyChangedEventArgs)Parameter
Die Ereignisdaten, die die geänderte Eigenschaft sowie alte und neue Werte beschreiben.
Hinweise
Diese Methode ist nicht für die allgemeine Erkennung von Eigenschaftsänderungen oder Ungültigmachungen 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 mehrmals während der Lebensdauer eines Objekts aufgerufen. Daher können Sie eine bessere Leistung 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 FrameworkElement 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.
Beachten Sie, dass eine identisch benannte OnPropertyChanged Methode mit einer anderen Signatur (der Parametertyp ist ) vorhanden ist PropertyChangedEventArgs, die in einer Reihe von Klassen angezeigt werden können. 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. Wenn dies nicht der Fall ist, wird das gesamte WPF-Eigenschaftensystem erheblich deaktiviert, was dazu führt, dass 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, dass die visuelle Struktur basierend auf Änderungen an der Formatvorlage zu geeigneten Zeitpunkten ungültig wird.
