DependencyObject.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 DependencyObject a été mise à jour. La propriété de dépendance spécifique qui a changé est signalée dans les données d’événement.

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

Données d’événement qui contiennent l’identificateur de propriété de dépendance présentant un intérêt, les métadonnées de propriété pour le type ainsi que les valeurs anciennes et nouvelles.

Remarques

Cette méthode n’est pas destinée à détecter de manière générale les modifications de propriétés individuelles ou à invalider des propriétés sur une base par cas. OnPropertyChanged 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. Par exemple, les modifications d’un Freezable peuvent être des modifications dans les types de valeurs de Freezable, ou peuvent être des sous-propriétés, où les modifications se trouvent dans d’autres Freezable références. L’implémentation Freezable de remplacement de utilise des OnPropertyChanged 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 pour chaque cas.

OnPropertyChanged est potentiellement appelé plusieurs fois pendant la durée de vie d’un objet. 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, puis si vous attachez CoerceValueCallback ou PropertyChangedCallback des fonctions pour des propriétés individuelles. Toutefois, vous utiliserez cette méthode si un DependencyObject inclut un nombre important de propriétés de dépendance liées entre des valeurs, 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é.

Notes pour les héritiers

Appelez toujours l’implémentation de base. Si vous ne le faites pas, cela désactive considérablement l’ensemble du système de propriétés WPF, ce qui entraîne la signalement de valeurs incorrectes.

S’applique à

Voir aussi