Skip to main content
FrameworkElementBeginInit Method
 

Starts the initialization process for this element.

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

Syntax
public virtual void BeginInit()
public:
virtual void BeginInit()
abstract BeginInit : unit -> unit
override BeginInit : unit -> unit
Public Overridable Sub BeginInit
Remarks

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.

Version Information
.NET Framework
Available since 3.0
Return to top