Partager via


FrameworkContentElement.OnPropertyChanged 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. La propriété de dépendance spécifique qui a changé est indiquée dans le paramètre d’arguments. Substitue 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)

Paramètres

e
DependencyPropertyChangedEventArgs

Données d’événement qui décrivent la propriété ayant changé, dont les anciennes et nouvelles valeurs.

Remarques

Cette méthode n’est pas destinée à détecter généralement les modifications de propriété ou les invalidations. Il est plutôt destiné aux modifications du modèle d’invalidation général si certaines informations sont connues sur les classifications étendues des propriétés.

Cette méthode est potentiellement appelée plusieurs fois pendant la durée de vie d’un objet. Par conséquent, vous pouvez obtenir de meilleures performances si vous remplacez les métadonnées de propriétés spécifiques, puis l’attachement CoerceValueCallback ou PropertyChangedCallback les fonctions pour des propriétés individuelles. Toutefois, vous utiliserez cette méthode si un FrameworkContentElement nombre important de propriétés de dépendance liées à la valeur est inclus, ou s’il inclut une logique telle que le comportement de rendu qui doit être réexécuté pour plusieurs cas connexes d’invalidations de propriété.

Notez qu’il existe une méthode nommée identiquement OnPropertyChanged avec une signature différente (le type de paramètre est PropertyChangedEventArgs) qui peut apparaître sur un certain nombre de classes. Utilisé OnPropertyChanged pour les notifications d’objet de données et fait partie du contrat pour INotifyPropertyChanged.

Notes pour les héritiers

Appelez toujours l’implémentation de base, comme première opération dans votre implémentation. L’échec de cette opération désactive considérablement l’ensemble du système de propriétés WPF, ce qui entraîne le signalement de valeurs incorrectes.

S’applique à

Voir aussi