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

Définition

Méthode appelée chaque fois que la valeur effective d’une propriété de dépendance sur ce DependencyObject a été mise à jour.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. La propriété de dépendance spécifique qui a été modifiée est signalée dans les données d'événement.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)

Paramètres

e
DependencyPropertyChangedEventArgs DependencyPropertyChangedEventArgs DependencyPropertyChangedEventArgs DependencyPropertyChangedEventArgs

Données d'événement qui contiendront l'identificateur de propriété de dépendance, les métadonnées de propriété pour le type, ainsi que les anciennes et nouvelles valeurs.Event data that will contain the dependency property identifier of interest, the property metadata for the type, and old and new values.

Remarques

Cette méthode n’est pas destinée à détecter les modifications de propriété individuelles ou à effectuer des invalidations de propriétés au cas par cas.This method is not intended to generally detect individual property changes or perform invalidations of properties on a per-case basis. OnPropertyChangedest plutôt destiné aux modifications du modèle d’invalidation générale, si certaines informations sont connues sur des classifications de propriétés étendues.OnPropertyChanged is instead intended for modifications of the general invalidation pattern, if certain information is known about wide classifications of properties. Par exemple, les modifications apportées à un Freezable peuvent être des modifications dans les types valeur Freezablede, ou peuvent être des sous-propriétés, Freezable où les modifications se trouvent dans d’autres références.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. L' Freezable implémentation de substitution de OnPropertyChanged utilise des informations internes pour déterminer si les propriétés sont des sous-propriétés et fournit une logique de classe de base appropriée dans les deux cas.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.

OnPropertyChangedest potentiellement appelé plusieurs fois pendant la durée de vie d’un objet.OnPropertyChanged is potentially invoked many times during the life of an object. Par conséquent, vous pouvez obtenir de meilleures performances pour le système de propriétés global si vous remplacez les métadonnées de propriétés spécifiques CoerceValueCallback , PropertyChangedCallback puis attachez ou des fonctions pour des propriétés individuelles.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. Toutefois, vous utilisez cette méthode si un DependencyObject comprend un nombre significatif de propriétés de dépendance liées à la valeur, ou si elle comprend une logique telle que le comportement de rendu qui doit être réexécuté pour plusieurs cas connexes d’invalidations de propriété.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.

Notes pour les héritiers

Appelez toujours l’implémentation de base.Always call the base implementation. Si vous ne le faites pas, la totalité WPFWPF du système de propriétés est désactivée de façon significative, ce qui entraîne le signalement de valeurs incorrectes.Failure to do this will significantly disable the entire WPFWPF property system, causing incorrect values to be reported.

S’applique à

Voir aussi