FrameworkElement.OnPropertyChanged(DependencyPropertyChangedEventArgs) FrameworkElement.OnPropertyChanged(DependencyPropertyChangedEventArgs) FrameworkElement.OnPropertyChanged(DependencyPropertyChangedEventArgs) FrameworkElement.OnPropertyChanged(DependencyPropertyChangedEventArgs) Method

Définition

Méthode appelée chaque fois que la valeur effective d’une propriété de dépendance sur ce FrameworkElement a été mise à jour.Invoked whenever the effective value of any dependency property on this FrameworkElement 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. Substitue OnPropertyChanged(DependencyPropertyChangedEventArgs).Overrides 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 DependencyPropertyChangedEventArgs DependencyPropertyChangedEventArgs DependencyPropertyChangedEventArgs

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

Remarques

Cette méthode n’est pas destinée à généralement détecter les modifications apportées aux propriétés ou les invalidations.This method is not intended to generally detect property changes or invalidations. Il est destiné à la place les modifications du modèle d’invalidation général si certaines informations sont connues de larges classifications de propriétés.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 appelée potentiellement 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 substituez les métadonnées de propriétés spécifiques puis attachez CoerceValueCallback ou PropertyChangedCallback fonctions pour les 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 utiliseriez cette méthode si un FrameworkElement inclut un nombre important de propriétés de dépendance mises en corrélation par valeur, ou si elle inclut la logique comme comportement de rendu qui doit être réexécuté pour plusieurs cas d’invalidations de propriétés connexes.However, you would use this method if a FrameworkElement 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 portant le même nom OnPropertyChanged méthode avec une signature différente (le type de paramètre est PropertyChangedEventArgs) qui peuvent apparaître sur un nombre de 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. Que OnPropertyChanged est utilisé pour les notifications d’objet 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. Entier sera considérablement désactivé dans le cas WPFWPF système de propriétés, 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. Spécifique au FrameworkElement implémentation est également chargée de maintenir un état approprié pour un large éventail de propriétés qui affectent l’interface utilisateur visible.The specific FrameworkElement implementation is also responsible for maintaining proper state for a variety of properties that affect the visible user interface. Celles-ci incluent l’invalidation de l’arborescence visuelle selon les modifications apportées au style à des moments appropriés.These include invalidating the visual tree based on changes to style at appropriate times.

S’applique à

Voir aussi