This documentation is archived and is not being maintained.

ComponentDesigner.InitializeExistingComponent Method

Reinitializes an existing component.

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

public virtual void InitializeExistingComponent(
	IDictionary defaultValues


Type: System.Collections.IDictionary
A name/value dictionary of default values to apply to properties. May be null if no default values are specified.



The InitializeExistingComponent method is called when an existing component is being reinitialized. For example, this may occur after the user drags a component to another container.

You may use the defaultValues dictionary to apply recommended defaults to properties; however, you should not modify component properties aside from those stored in the dictionary, because this existing component may already have properties set on it.

The default implementation of this method does nothing.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

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