DesignSurface.BeginLoad 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.
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 -> unitPublic 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 -> unitPublic 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.
