FrameworkElement.OnPropertyChanged(DependencyPropertyChangedEventArgs) Método

Definición

Espacio de nombres:

System.Windows

Ensamblado:

PresentationFramework.dll

Se invoca cuando se actualiza el valor efectivo de alguna propiedad de dependencia en este FrameworkElement. Propiedad de dependencia concreta que cambió se notifica en el parámetro de argumentos. Invalida 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)

Parámetros

e

DependencyPropertyChangedEventArgs

Datos de evento que describen la propiedad que cambió, así como los valores antiguos y nuevos.

Comentarios

Este método no está pensado para detectar generalmente cambios o invalidaciones de propiedad. En su lugar, está pensado para modificaciones del patrón de invalidación general si se conoce cierta información sobre clasificaciones amplias de propiedades.

Este método se invoca potencialmente muchas veces durante la vida de un objeto . Por lo tanto, puede lograr un mejor rendimiento si invalida los metadatos de propiedades específicas y, a continuación, adjunta CoerceValueCallback o PropertyChangedCallback funciones para propiedades individuales. Sin embargo, usaría este método si FrameworkElement incluye un número significativo de propiedades de dependencia relacionadas con el valor, o si incluye lógica como el comportamiento de representación que se debe volver a ejecutar para varios casos relacionados de invalidaciones de propiedad.

Tenga en cuenta que hay un método con un nombre OnPropertyChanged idéntico con una firma diferente (el tipo de parámetro es PropertyChangedEventArgs) que puede aparecer en una serie de clases. Se OnPropertyChanged usa para las notificaciones de objetos de datos y forma parte del contrato para INotifyPropertyChanged.

Notas a los desarrolladores de herederos

Llame siempre a la implementación base, como la primera operación de la implementación. Si no se hace esto, se deshabilitará significativamente todo el sistema de propiedades de WPF, lo que hace que se notifiquen valores incorrectos. La implementación específica FrameworkElement también es responsable de mantener el estado adecuado para una variedad de propiedades que afectan a la interfaz de usuario visible. Entre ellas se incluye invalidar el árbol visual en función de los cambios en el estilo en los momentos adecuados.

Consulte también

• OnPropertyChanged(DependencyPropertyChangedEventArgs)
• PropertyChangedCallback