DependencyObject.OnPropertyChanged(DependencyPropertyChangedEventArgs) DependencyObject.OnPropertyChanged(DependencyPropertyChangedEventArgs) DependencyObject.OnPropertyChanged(DependencyPropertyChangedEventArgs) DependencyObject.OnPropertyChanged(DependencyPropertyChangedEventArgs) Method

Definition

Wird immer dann aufgerufen, wenn der effektive Wert einer Abhängigkeitseigenschaft für dieses DependencyObject aktualisiert wurde.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. Die spezifische Abhängigkeitseigenschaft, die sich geändert hat, wird in den Ereignisdaten angegeben.The specific dependency property that changed is reported in the event data.

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 DependencyPropertyChangedEventArgs DependencyPropertyChangedEventArgs DependencyPropertyChangedEventArgs

Ereignisdaten, die den Bezeichner der betroffenen Abhängigkeitseigenschaft, die Eigenschaftenmetadaten des Typs sowie die alten und neuen Werte enthalten.Event data that will contain the dependency property identifier of interest, the property metadata for the type, and old and new values.

Hinweise

Diese Methode ist nicht vorgesehen, in der Regel erkennen von Änderungen der einzelnen Eigenschaften oder invalidierungen der Eigenschaften, die pro-Fall zu Fall ausführen.This method is not intended to generally detect individual property changes or perform invalidations of properties on a per-case basis. OnPropertyChanged stattdessen für Änderungen der allgemeinen invalidierung-Muster, richtet sich an, wenn bestimmte Informationen über wide Klassifizierungen der Eigenschaften, die bekannt ist.OnPropertyChanged is instead intended for modifications of the general invalidation pattern, if certain information is known about wide classifications of properties. Ändert sich beispielsweise einer Freezable möglicherweise Änderungen in die Werttypen der der Freezable, oder möglicherweise Untereigenschaften, in dem die Änderungen in den anderen sind Freezable verweisen.For example, changes in a Freezable might be changes in the value types of the Freezable, or might be subproperties, where the changes are within other Freezable references. Die Freezable überschreiben Implementierung der OnPropertyChanged verwendet interne Informationen, um zu bestimmen, ob die Eigenschaften sind untergeordnete und entsprechenden Basisklasse Logik für das Vorarbeiten bereitstellt.The Freezable override implementation of OnPropertyChanged uses internal information to determine whether the properties are subproperties, and provides appropriate base class logic for either case.

OnPropertyChanged oft wird möglicherweise während der Lebensdauer eines Objekts aufgerufen werden.OnPropertyChanged is potentially invoked many times during the life of an object. Aus diesem Grund können Sie eine bessere Leistung für das gesamte Eigenschaftensystem erzielen, wenn Sie die Metadaten der bestimmte Eigenschaften überschreiben, und Sie dann fügen CoerceValueCallback oder PropertyChangedCallback Funktionen für die einzelnen Eigenschaften.Therefore, you can achieve better performance for the overall property system if you override the metadata of specific properties and then attach CoerceValueCallback or PropertyChangedCallback functions for individual properties. Allerdings würden Sie diese Methode verwenden, wenn eine DependencyObject umfasst eine Vielzahl von Wert in wechselseitiger Beziehung Abhängigkeitseigenschaften, oder wenn sie die Logik enthält, wie z. B. Renderingverhalten, die erneut ausgeführt werden, muss einige Fälle von eigenschafteninvalidierungen beziehen.However, you would use this method if a DependencyObject includes a significant number of value-interrelated dependency properties, or if it includes logic such as rendering behavior that must be rerun for several related cases of property invalidations.

Hinweise für Vererber

Rufen Sie immer die basisimplementierung.Always call the base implementation. Geschieht dies nicht die gesamte erheblich deaktiviert WPFWPF Eigenschaftensystem, bewirkt, dass falsche Werte gemeldet werden.Failure to do this will significantly disable the entire WPFWPF property system, causing incorrect values to be reported.

Gilt für:

Siehe auch