DesignSurface.BeginLoad Method

Definition

Namespace:

System.ComponentModel.Design

Assembly:

System.Windows.Forms.Design.dll

Begins the loading process.

Overloads

BeginLoad(DesignerLoader)	Begins the loading process with the given designer loader.
BeginLoad(Type)	Begins the loading process.

BeginLoad(DesignerLoader)

Source:

DesignSurface.cs

Begins the loading process with the given designer loader.

public:
 void BeginLoad(System::ComponentModel::Design::Serialization::DesignerLoader ^ loader);

public void BeginLoad (System.ComponentModel.Design.Serialization.DesignerLoader loader);

member this.BeginLoad : System.ComponentModel.Design.Serialization.DesignerLoader -> unit

Public Sub BeginLoad (loader As DesignerLoader)

Parameters

loader

DesignerLoader

The designer loader to use for loading the designer.

Exceptions

ArgumentNullException

loader is null.

ObjectDisposedException

The IDesignerHost attached to the DesignSurface has been disposed.

Remarks

Designer loading can be asynchronous, so the loading may continue to progress after this call has returned. Attach an event handler to the LoadComplete event to be notified when the design surface has completed loading.

After BeginLoad is called, you can immediately obtain the view for the designer, because designer loaders must provide at least the root component when loading asynchronously.

See also

• DesignerLoader
• IDesignerLoaderService

BeginLoad(Type)

Source:

DesignSurface.cs

Begins the loading process.

public:
 void BeginLoad(Type ^ rootComponentType);

public void BeginLoad (Type rootComponentType);

member this.BeginLoad : Type -> unit

Public Sub BeginLoad (rootComponentType As Type)

Parameters

rootComponentType

Type

The type of component to create in design mode.

Exceptions

ArgumentNullException

rootComponentType is null.

ObjectDisposedException

The IDesignerHost attached to the DesignSurface has been disposed.

Remarks

When rootComponentType is specified, a default designer loader that simply creates an instance of rootComponentType will be used. Designer loading can be asynchronous, so the loading may continue to progress after this call has returned. Attach an event handler to the LoadComplete event to be notified when the design surface has completed loading.

After BeginLoad is called, you can immediately obtain the view for the designer, because designer loaders must provide at least the root component when loading asynchronously.

Note

The BeginLoad method creates an instance of the component type and initializes a designer for this instance. The Loaded event is raised before this method returns.