BeginInit Method

FrameworkElement.BeginInit Method ()


Starts the initialization process for this element.

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

public virtual void 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
Available since 3.0
Return to top
© 2015 Microsoft