FrameworkContentElement.OnPropertyChanged Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Se invoca cuando se actualiza el valor efectivo de alguna propiedad de dependencia en este FrameworkContentElement. 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 -> unitProtected Overrides Sub OnPropertyChanged (e As DependencyPropertyChangedEventArgs)Parámetros
Datos del evento que describen la propiedad que cambió, incluidos 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 las clasificaciones amplias de las 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 FrameworkContentElement 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 OnPropertyChanged nombre 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.