Para ver el artículo en inglés, active la casilla Inglés. También puede ver el texto en inglés en una ventana emergente si pasa el puntero del mouse por el texto.
Traducción
Inglés
Esta documentación está archivada y no tiene mantenimiento.

DependencyObject.OnPropertyChanged (Método)

Invocado siempre que el valor efectivo de cualquier propiedad de dependencia en este DependencyObject se haya actualizado. Se informa de la propiedad de dependencia concreta que cambió en los datos de evento.

Espacio de nombres:  System.Windows
Ensamblado:  WindowsBase (en WindowsBase.dll)

protected virtual void OnPropertyChanged(
	DependencyPropertyChangedEventArgs e
)

Parámetros

e
Tipo: System.Windows.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.

Este método no está pensado para detectar, por lo general, los cambios de propiedad individual o realizar invalidaciones de las propiedades de una por cada caso. OnPropertyChanged , por el contrario, se ha concebido para las modificaciones del modelo de invalidación general, si se conoce cierta información sobre amplias clasificaciones de propiedades. Por ejemplo, los cambios en Freezable podrían ser cambios en los tipos de valor de Freezable o podrían ser subpropiedades, donde los cambios están en otras referencias Freezable. La implementación de invalidación Freezable de OnPropertyChanged usa la información interna para determinar si las propiedades son subpropiedades y proporciona la lógica de clase base adecuada en ambos casos.

OnPropertyChanged se invoca posiblemente muchas veces durante la vida de un objeto. Por consiguiente, puede lograr el mejor rendimiento para el sistema de propiedades total si invalida los metadatos de propiedades concretas y, a continuación, asocia las funciones CoerceValueCallback o PropertyChangedCallback para las propiedades individuales. Sin embargo, debe usar este método si DependencyObject incluye un número significativo de propiedades de dependencia interrelacionadas por 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 para los herederos

Llame siempre a la implementación base. No hacerlo deshabilitaría significativamente todo el sistema de propiedades de WPF y se informaría de valores incorrectos.

Nota importanteImportante

El método OnPropertyChanged tiene un gran potencial para introducir problemas de reentrada a través de la implementación. Evite los siguientes casos de reentrada posibles al implementar:

No introduzca una UI modal o sostenga de otra forma el subproceso de la UI.

No introduzca ningún bombeo de mensajes desde OnPropertyChanged. Las respuestas a mensajes (en particular, el control nativo del que podría no ser consciente) activarían cambios de propiedad más extensos.

.NET Framework

Compatible con: 4, 3.5, 3.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
Mostrar: