IComponentInitializer Interface


The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Provides a set of recommended default values during component creation.

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

public interface IComponentInitializer


Restores an instance of a component to its default state.


Initializes a new component using a set of recommended values.

The IComponentInitializer interface can be implemented by any designer, which is a component that also implements IDesigner, which receives a recommended set of default values for the component it is designing. IComponentInitializer is queried during new component creation. Recommended default values for the component's properties are passed in as name/value pairs in a dictionary.

This design provides two customization points: the toolbox item itself can be replaced or changed to perform custom actions, or the designer for a component can be changed to provide a custom action. A designer that implements IComponentInitializer should not depend on either of its methods—InitializeNewComponent or InitializeExistingComponent—being called, because toolbox items are not obligated to call these methods.

For an overview of creating design components, see Extending Design-Time Support.

.NET Framework
Available since 2.0
Return to top