FrameworkContentElement.OnPropertyChanged(DependencyPropertyChangedEventArgs) Méthode

Définition

Méthode appelée chaque fois que la valeur effective d’une propriété de dépendance sur ce FrameworkContentElement a été mise à jour.Invoked whenever the effective value of any dependency property on this FrameworkContentElement has been updated. La propriété de dépendance spécifique qui a changé est indiquée dans le paramètre d’arguments.The specific dependency property that changed is reported in the arguments parameter. Remplace OnPropertyChanged(DependencyPropertyChangedEventArgs).Overrides OnPropertyChanged(DependencyPropertyChangedEventArgs).

protected:
 override void OnPropertyChanged(System::Windows::DependencyPropertyChangedEventArgs e);
protected override void OnPropertyChanged (System.Windows.DependencyPropertyChangedEventArgs e);
abstract member OnPropertyChanged : System.Windows.DependencyPropertyChangedEventArgs -> unit
override this.OnPropertyChanged : System.Windows.DependencyPropertyChangedEventArgs -> unit
override this.OnPropertyChanged : System.Windows.DependencyPropertyChangedEventArgs -> unit
Protected Overrides Sub OnPropertyChanged (e As DependencyPropertyChangedEventArgs)

Paramètres

e
DependencyPropertyChangedEventArgs

Données d’événement qui décrivent la propriété ayant changé, dont les anciennes et nouvelles valeurs.The event data that describes the property that changed, including the old and new values.

Remarques

Cette méthode n’est pas destinée à détecter généralement les modifications de propriété ou les invalidations.This method is not intended to generally detect property changes or invalidations. À la place, elle est destinée à apporter des modifications au modèle d’invalidation générale si certaines informations sont connues sur des classifications de propriétés étendues.It is instead intended for modifications of the general invalidation pattern if certain information is known about wide classifications of properties.

Cette méthode est potentiellement appelée plusieurs fois pendant la durée de vie d’un objet.This method is potentially invoked many times during the life of an object. Par conséquent, vous pouvez obtenir de meilleures performances si vous remplacez les métadonnées de propriétés spécifiques, puis attachez CoerceValueCallback ou PropertyChangedCallback des fonctions pour des propriétés individuelles.Therefore, you can achieve better performance 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 FrameworkContentElement 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 FrameworkContentElement 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.

Notez qu’il existe une méthode portant le même nom OnPropertyChanged avec une signature différente (le type de paramètre est PropertyChangedEventArgs ) qui peut apparaître sur plusieurs classes.Note that there is an identically named OnPropertyChanged method with a different signature (the parameter type is PropertyChangedEventArgs) that can appear on a number of classes. OnPropertyChangedUtilisé pour les notifications d’objets de données et fait partie du contrat pour INotifyPropertyChanged .That OnPropertyChanged is used for data object notifications, and is part of the contract for INotifyPropertyChanged.

Notes pour les héritiers

Appelez toujours l’implémentation de base, comme première opération dans votre implémentation.Always call the base implementation, as the first operation in your implementation. Si vous ne le faites pas, la totalité du système de propriétés est désactivée WPFWPF , ce qui entraîne le signalement de valeurs incorrectes.Failure to do this will significantly disable the entire WPFWPF property system, which causes incorrect values to be reported.

S’applique à

Voir aussi