DependencyObject.OnPropertyChanged(DependencyPropertyChangedEventArgs) 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 DependencyObject. La propiedad de dependencia específica que cambió se notifica en los datos de evento.
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 -> unitProtected Overridable Sub OnPropertyChanged (e As DependencyPropertyChangedEventArgs)Parámetros
Datos de evento que contendrán el identificador de propiedad de dependencia de interés, los metadatos del tipo de propiedad, y valores antiguos y nuevos.
Comentarios
Este método no está pensado para detectar generalmente cambios de propiedad individuales ni realizar invalidaciones de propiedades por caso. OnPropertyChanged 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. Por ejemplo, los cambios de un Freezable elemento pueden ser cambios en los tipos de valor de Freezable, o pueden ser subpropiedades, donde los cambios están dentro de otras Freezable referencias. 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.
OnPropertyChanged se invoca potencialmente muchas veces durante la vida de un objeto. Por lo tanto, puede lograr un mejor rendimiento para el sistema de propiedades general 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 DependencyObject 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.
Notas a los desarrolladores de herederos
Llame siempre a la implementación base. Si no lo hace, se deshabilitará significativamente todo el sistema de propiedades de WPF, lo que provocará que se notifiquen valores incorrectos.
