UIElement.OnDisconnectVisualChildren Method
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Override this method to implement how layout and logic should behave when items are removed from a class-specific content or children property.
protected:
virtual void OnDisconnectVisualChildren() = OnDisconnectVisualChildren;void OnDisconnectVisualChildren();protected virtual void OnDisconnectVisualChildren();function onDisconnectVisualChildren()Protected Overridable Sub OnDisconnectVisualChildren ()UIElement does not define any of the content model properties that OnDisconnectVisualChildren might act upon. Such properties are introduced deeper in an inheritance, for example at the ContentControl level.
FrameworkElement uses an OnDisconnectVisualChildren override to clear values from DataContext and Tag. In general, if you override this method you should always call the base implementation so that the framework-intentional behavior that acts on OnDisconnectVisualChildren can be preserved.
VisualTreeHelper.DisconnectChildrenRecursive is a similar static helper API that can be called by app code.
| Product | Versions |
|---|---|
| WinRT | Build 10240, Build 10586, Build 14383, Build 15063, Build 16299, Build 17134, Build 17763, Build 18362, Build 19041, Build 20348, Build 22000, Build 22621, Build 26100 |