IDesignerLoaderService Interface

Provides an interface that can extend a designer loader to support asynchronous loading of external components.

Namespace:  System.ComponentModel.Design.Serialization
Assembly:  System (in System.dll)

public interface IDesignerLoaderService

The IDesignerLoaderService type exposes the following members.

Public methodAddLoadDependencyRegisters an external component as part of the load process managed by this interface.
Public methodDependentLoadCompleteSignals that a dependent load has finished.
Public methodReloadReloads the design document.

A DesignerLoader can implement this interface to manage designer loading that involves external components. This interface also allows external components to initiate a reload of the design surface by calling Reload. A designer loader does not have to implement this interface if it does not require support for asynchronous loading.

Designer loading using a custom implementation of the IDesignerLoaderService can occur in a variety of ways. Sometimes external components are involved in the loading process. To facilitate loading with external dependencies, the designer loader service interface provides a mechanism that determines when loading is complete and allows each portion of loading to signal that it has completed. The IDesignerLoaderService typically determines when loading is complete by testing a counter that tracks the number of load dependencies remaining. When each portion of the load completes, DependentLoadComplete is called, and the service decrements the counter. To set the number of dependent load processes, call AddLoadDependency once for each load process that calls DependentLoadComplete when its loading is complete. When the final loading is complete, the service calls EndLoad on the loader host.

.NET Framework

Supported in: 4.5.3, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
© 2014 Microsoft