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 les modifications de propriété individuelles ou à effectuer des invalidations de propriétés au cas par cas. OnPropertyChanged est 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. Par exemple, les modifications apportées à un Freezable peuvent être des modifications dans les types valeur de Freezable , ou peuvent être des sous-propriétés, où les modifications se trouvent dans d’autres Freezable références. 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.

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 attachez CoerceValueCallback ou PropertyChangedCallback des fonctions pour des propriétés individuelles. 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é.

Notes pour les héritiers

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

S’applique à

Voir aussi