This documentation is archived and is not being maintained.

DependencyPropertyChangedEventHandler Delegate

Represents the method that will handle events raised when a DependencyProperty is changed on a particular DependencyObject implementation.

Namespace:  System.Windows
Assembly:  WindowsBase (in WindowsBase.dll)

public delegate void DependencyPropertyChangedEventHandler(
	Object sender,
	DependencyPropertyChangedEventArgs e


Type: System.Object
The source of the event.
Type: System.Windows.DependencyPropertyChangedEventArgs
The event data.

This delegate is the handler signature for particular events that report dependency property changes.

An event that uses this handler is exposed as a common language runtime (CLR) event, not as a routed event. Typically these events follow the naming pattern Is(PropertyName)Changed, where PropertyName is the DependencyProperty.Name of the property that changed. The arguments of the event are used to query the old and new value of the property, as reported by the particular event. Typically there is a 1:1 correspondence between properties that change and a particular event that reports the change. It is also possible, though uncommon, to have the same event report changes to more than one property. In this case, the DependencyPropertyChangedEventArgs should be checked to determine the property that changed.

The event data class DependencyPropertyChangedEventArgs has a wider usage than just this delegate. DependencyPropertyChangedEventArgs is also used to communicate data for PropertyChangedCallback implementations, which are part of the customization features and internals of the WPF property system, and by the OnPropertyChanged virtual method, which can be overridden to provide class-specific notifications whenever any dependency property on the object changes.

.NET Framework

Supported in: 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.