DependencyObject.OnPropertyChanged(DependencyPropertyChangedEventArgs) DependencyObject.OnPropertyChanged(DependencyPropertyChangedEventArgs) DependencyObject.OnPropertyChanged(DependencyPropertyChangedEventArgs) DependencyObject.OnPropertyChanged(DependencyPropertyChangedEventArgs) Method

Definición

Se invoca cuando se actualiza el valor efectivo de alguna propiedad de dependencia en este DependencyObject.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. Se informa de la propiedad de dependencia concreta que cambió en los datos de evento.The specific dependency property that changed is reported in the event data.

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)

Parámetros

e
DependencyPropertyChangedEventArgs DependencyPropertyChangedEventArgs DependencyPropertyChangedEventArgs DependencyPropertyChangedEventArgs

Datos de evento que contendrán el identificador de la propiedad de dependencia de interés, los metadatos de propiedad para el tipo y los valores anteriores y nuevos.Event data that will contain the dependency property identifier of interest, the property metadata for the type, and old and new values.

Comentarios

Este método no está pensado para detectar normalmente los cambios de propiedad individuales o realizar invalidaciones de las propiedades en cada caso.This method is not intended to generally detect individual property changes or perform invalidations of properties on a per-case basis. OnPropertyChangeden su lugar, está pensado para las modificaciones del patrón de invalidación general, si se conoce cierta información acerca de las clasificaciones anchas de propiedades.OnPropertyChanged is instead intended for modifications of the general invalidation pattern, if certain information is known about wide classifications of properties. Por ejemplo, los cambios en Freezable puede ser cambios en los tipos Freezablede valor de, o podrían ser subpropiedades, donde los cambios se encuentran Freezable dentro de otras referencias.For example, changes in a Freezable might be changes in the value types of the Freezable, or might be subproperties, where the changes are within other Freezable references. La Freezable implementación de invalidación de OnPropertyChanged usa información interna para determinar si las propiedades son subpropiedades y proporciona la lógica de clase base adecuada para cualquier caso.The Freezable override implementation of OnPropertyChanged uses internal information to determine whether the properties are subproperties, and provides appropriate base class logic for either case.

OnPropertyChangedse invoca potencialmente muchas veces durante la vida de un objeto.OnPropertyChanged is potentially invoked many times during the life of an object. Por lo tanto, puede lograr un mejor rendimiento para el sistema de propiedades general si invalida los metadatos de propiedades concretas CoerceValueCallback y PropertyChangedCallback , a continuación, asocia o funciones para propiedades individuales.Therefore, you can achieve better performance for the overall property system if you override the metadata of specific properties and then attach CoerceValueCallback or PropertyChangedCallback functions for individual properties. Sin embargo, se usaría este método si un DependencyObject incluye un número significativo de propiedades de dependencia interrelacionadas con valores, o si incluye lógica como el comportamiento de la representación que se debe volver a ejecutar para varios casos relacionados de invalidaciones de propiedad.However, you would use this method if a DependencyObject 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.

Notas a los desarrolladores de herederos

Llame siempre a la implementación base.Always call the base implementation. Si no lo hace, se deshabilitará WPFWPF de forma significativa todo el sistema de propiedades, lo que provocará que se notifiquen valores incorrectos.Failure to do this will significantly disable the entire WPFWPF property system, causing incorrect values to be reported.

Se aplica a

Consulte también: