Edit

Share via


DesignSurface.BeginLoad Method

Definition

Begins the loading process.

Overloads

BeginLoad(DesignerLoader)

Begins the loading process with the given designer loader.

BeginLoad(Type)

Begins the loading process.

BeginLoad(DesignerLoader)

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

loader is null.

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

Applies to

BeginLoad(Type)

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

rootComponentType is null.

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.

Applies to