FrameworkElement::BeginInit Method

Starts the initialization process for this element.

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

public:
virtual void BeginInit()

Implements

ISupportInitialize::BeginInit()

You can call this method on individual elements if you are adjusting them in ways that do not yet expose or connect the element to any element tree. For instance, you might have created a new FrameworkElement, but have not yet attached it to any logical tree. Or, the logical tree where your element is a child element within it might not be connected to a window or page of the application.

Notes to Inheritors

Implement this method to provide special handling that should happen before your element is initialized during the element loading process.

Your implementation should call the base implementation, because the base (default) implementation sets some internal flags to keep track of initialization. One possible implementation is to use this method as a hook into your own private class initialization routines that are not already enabled by constructors.

The base implementation will throw an exception if BeginInit is called more than one time on the same element prior to EndInit being called.

.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