FrameworkElement.OnPropertyChanged(DependencyPropertyChangedEventArgs) Metodo

Definizione

Richiamato ogni volta che viene aggiornato il valore effettivo di qualsiasi proprietà di dipendenza in FrameworkElement.Invoked whenever the effective value of any dependency property on this FrameworkElement has been updated. La proprietà di dipendenza specifica modificata viene indicata nel parametro degli argomenti.The specific dependency property that changed is reported in the arguments parameter. Esegue l'override di 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)

Parametri

e
DependencyPropertyChangedEventArgs

Dati dell'evento che descrivono la proprietà modificata, nonché i valori vecchio e nuovo.The event data that describes the property that changed, as well as old and new values.

Commenti

Questo metodo non è destinato a rilevare generalmente le modifiche delle proprietà o le invalide.This method is not intended to generally detect property changes or invalidations. È invece destinato alle modifiche del modello di invalidamento generale se determinate informazioni sono note sulle classificazioni estese delle proprietà.It is instead intended for modifications of the general invalidation pattern if certain information is known about wide classifications of properties.

Questo metodo viene potenzialmente richiamato più volte durante il ciclo di vita di un oggetto.This method is potentially invoked many times during the life of an object. Pertanto, è possibile ottenere prestazioni migliori se si esegue l'override dei metadati di proprietà specifiche e quindi si alleghino CoerceValueCallback o funzioni PropertyChangedCallback per le singole proprietà.Therefore, you can achieve better performance if you override the metadata of specific properties and then attach CoerceValueCallback or PropertyChangedCallback functions for individual properties. Tuttavia, è possibile utilizzare questo metodo se un FrameworkElement include un numero significativo di proprietà di dipendenza correlate al valore o se include una logica quale il comportamento di rendering che deve essere rieseguita per diversi casi correlati di invalidamenti di proprietà.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.

Si noti che esiste un metodo OnPropertyChanged con nome identico con una firma diversa (il tipo di parametro è PropertyChangedEventArgs) che può essere visualizzato in un numero di classi.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. Tale OnPropertyChanged viene utilizzata per le notifiche di oggetti dati ed è parte del contratto per INotifyPropertyChanged.That OnPropertyChanged is used for data object notifications, and is part of the contract for INotifyPropertyChanged.

Note per gli eredi

Chiamare sempre l'implementazione di base come prima operazione nell'implementazione.Always call the base implementation, as the first operation in your implementation. In caso contrario, l'intero sistema di proprietà WPFWPF verrà disabilitato in modo significativo, causando la segnalazione di valori non corretti.Failure to do this will significantly disable the entire WPFWPF property system, which causes incorrect values to be reported. L'implementazione di FrameworkElement specifica è inoltre responsabile della gestione dello stato appropriato per un'ampia gamma di proprietà che interessano l'interfaccia utente visibile.The specific FrameworkElement implementation is also responsible for maintaining proper state for a variety of properties that affect the visible user interface. Questi includono l'invalidamento della struttura ad albero visuale in base alle modifiche apportate allo stile in momenti appropriatiThese include invalidating the visual tree based on changes to style at appropriate times.

Si applica a

Vedi anche