BasicDesignerLoader BasicDesignerLoader BasicDesignerLoader BasicDesignerLoader Class


Provides an implementation of the IDesignerLoaderService interface.

public ref class BasicDesignerLoader abstract : System::ComponentModel::Design::Serialization::DesignerLoader, System::ComponentModel::Design::Serialization::IDesignerLoaderService
public abstract class BasicDesignerLoader : System.ComponentModel.Design.Serialization.DesignerLoader, System.ComponentModel.Design.Serialization.IDesignerLoaderService
type BasicDesignerLoader = class
    inherit DesignerLoader
    interface IDesignerLoaderService
Public MustInherit Class BasicDesignerLoader
Inherits DesignerLoader
Implements IDesignerLoaderService


A BasicDesignerLoader is a complete implementation of a designer loader without anything relating to a persistence format. A BasicDesignerLoader does not dictate either a text or binary persistence, but it does support the following features:

  • Multiple load dependencies.

  • Tracking changes within the designer.

  • Deferred idle-time reloading.

A BasicDesignerLoader adds two kinds of services to the designer host's service container: replaceable services and irreplaceable services. You can replace a replaceable service by changing the value of the protected LoaderHost property. You cannot replace irreplaceable services because their implementations depend on each other.

The following table describes the services that are provided by default.

Default Service Description
IDesignerLoaderService Allows objects to request that the designer reload itself when it is idle. This is a replaceable service.
IDesignerSerializationManager Used to serialize and deserialize objects. The serialization manager is added as a service so objects that need to perform serialization can utilize any serialization providers that were added to the serialization manager. This is an irreplaceable service.


BasicDesignerLoader() BasicDesignerLoader() BasicDesignerLoader() BasicDesignerLoader()

Initializes a new instance of the BasicDesignerLoader class.


LoaderHost LoaderHost LoaderHost LoaderHost

Gets the loader host.

Loading Loading Loading Loading

Gets a value indicating whether the designer loader is loading the design surface.

Modified Modified Modified Modified

Gets or sets a value indicating whether the designer has been modified.

PropertyProvider PropertyProvider PropertyProvider PropertyProvider

Gets or sets the property provider for the serialization manager being used by the loader.

ReloadPending ReloadPending ReloadPending ReloadPending

Gets a value indicating whether a reload has been queued.


BeginLoad(IDesignerLoaderHost) BeginLoad(IDesignerLoaderHost) BeginLoad(IDesignerLoaderHost) BeginLoad(IDesignerLoaderHost)

Starts the loading process.

Dispose() Dispose() Dispose() Dispose()

Releases the resources used by the BasicDesignerLoader.

EnableComponentNotification(Boolean) EnableComponentNotification(Boolean) EnableComponentNotification(Boolean) EnableComponentNotification(Boolean)

Enables or disables component notification with the DesignerLoader.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determines whether the specified object is equal to the current object.

(Inherited from Object)
Flush() Flush() Flush() Flush()

Flushes pending changes to the designer loader.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Serves as the default hash function.

(Inherited from Object)
GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Gets the requested service.

GetType() GetType() GetType() GetType()

Gets the Type of the current instance.

(Inherited from Object)
Initialize() Initialize() Initialize() Initialize()

Initializes services.

IsReloadNeeded() IsReloadNeeded() IsReloadNeeded() IsReloadNeeded()

Indicates whether the designer should be reloaded.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Creates a shallow copy of the current Object.

(Inherited from Object)
OnBeginLoad() OnBeginLoad() OnBeginLoad() OnBeginLoad()

Notifies the designer loader that loading is about to begin.

OnBeginUnload() OnBeginUnload() OnBeginUnload() OnBeginUnload()

Notifies the designer loader that unloading is about to begin.

OnEndLoad(Boolean, ICollection) OnEndLoad(Boolean, ICollection) OnEndLoad(Boolean, ICollection) OnEndLoad(Boolean, ICollection)

Notifies the designer loader that loading is complete.

OnModifying() OnModifying() OnModifying() OnModifying()

Notifies the designer loader that the state of the document is about to be modified.

PerformFlush(IDesignerSerializationManager) PerformFlush(IDesignerSerializationManager) PerformFlush(IDesignerSerializationManager) PerformFlush(IDesignerSerializationManager)

Flushes all changes to the designer.

PerformLoad(IDesignerSerializationManager) PerformLoad(IDesignerSerializationManager) PerformLoad(IDesignerSerializationManager) PerformLoad(IDesignerSerializationManager)

Loads a designer from persistence.

Reload(BasicDesignerLoader+ReloadOptions) Reload(BasicDesignerLoader+ReloadOptions) Reload(BasicDesignerLoader+ReloadOptions) Reload(BasicDesignerLoader+ReloadOptions)

Queues a reload of the designer.

ReportFlushErrors(ICollection) ReportFlushErrors(ICollection) ReportFlushErrors(ICollection) ReportFlushErrors(ICollection)

Reports errors that occurred while flushing changes.

SetBaseComponentClassName(String) SetBaseComponentClassName(String) SetBaseComponentClassName(String) SetBaseComponentClassName(String)

Sets the full class name of the base component.

ToString() ToString() ToString() ToString()

Returns a string that represents the current object.

(Inherited from Object)

Explicit Interface Implementations

IDesignerLoaderService.AddLoadDependency() IDesignerLoaderService.AddLoadDependency() IDesignerLoaderService.AddLoadDependency() IDesignerLoaderService.AddLoadDependency()

Registers an external component as part of the load process managed by IDesignerLoaderService.

IDesignerLoaderService.DependentLoadComplete(Boolean, ICollection) IDesignerLoaderService.DependentLoadComplete(Boolean, ICollection) IDesignerLoaderService.DependentLoadComplete(Boolean, ICollection) IDesignerLoaderService.DependentLoadComplete(Boolean, ICollection)

Signals that a dependent load has finished.

IDesignerLoaderService.Reload() IDesignerLoaderService.Reload() IDesignerLoaderService.Reload() IDesignerLoaderService.Reload()

Reloads the design document.


for full access to system resources. Demand values: LinkDemand, InheritanceDemand. Associated state:

Applies to

See also