FrameworkElement.BeginInit Method
Definition
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.
Starts the initialization process for this element.
public:
virtual void BeginInit();public virtual void BeginInit ();abstract member BeginInit : unit -> unit
override this.BeginInit : unit -> unitPublic Overridable Sub BeginInit ()Implements
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.
