FrameworkElement::DataContextChanged Event

Occurs when the data context for this element changes.

Namespace:  System.Windows
Assembly:  PresentationFramework (in PresentationFramework.dll)
XMLNS for XAML: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation

public:
 event DependencyPropertyChangedEventHandler^ DataContextChanged {
	void add (DependencyPropertyChangedEventHandler^ value);
	void remove (DependencyPropertyChangedEventHandler^ value);
}
<object DataContextChanged="DependencyPropertyChangedEventHandler" .../>

For an explanation of data contexts and data binding, see Data Binding Overview.

Important noteImportant

When the DataContext for an element changes, all data-bound properties on this element are potentially affected. This applies to any elements that are child elements of the current element in the logical tree, which inherit the data context, and also the current element itself. All such existing bindings must re-interpret the new DataContext and will reevaluate the binding results. The data binding engine is not deterministic about the order of these reevaluations, relative to the raising of the DataContextChanged event. The reevaluations can occur before the event, after the event, or in any mixture.

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2015 Microsoft