FrameworkElement.BeginInit Method

Definition

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

Starts the initialization process for this element.

public:
 virtual void BeginInit();

public virtual void BeginInit ();

abstract member BeginInit : unit -> unit
override this.BeginInit : unit -> unit

Public Overridable Sub BeginInit ()

Implements

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.

See also

• EndInit()