FrameworkElement.DataContextChanged Event

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Occurs when the data context for this element changes.

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

Syntax

'Declaration
Public Event DataContextChanged As DependencyPropertyChangedEventHandler
public event DependencyPropertyChangedEventHandler DataContextChanged
<frameworkElement DataContextChanged="eventhandler"/>

Remarks

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

Important noteImportant Note:

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.

Version Information

Silverlight

Supported in: 5

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.