ControlDesigner.RegisterClone Method (Object, Object)


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

Registers internal data in a cloned control.

Namespace:   System.Web.UI.Design
Assembly:  System.Design (in System.Design.dll)

public void RegisterClone(
	object original,
	object clone


Type: System.Object

The control associated with the control designer.

Type: System.Object

The cloned copy of the associated control.

Exception Condition

original is null.


clone is null.

Whenever an item is cloned, there might be some internal data structures, such as meta: attributes, that should be included in the cloned control by the control designer. A page developer might add meta: attributes to the markup of a control and there is no way, nor is there a reason, for the control to distinguish what those tags might be. Therefore, if your control designer provides a way to edit complex properties or formats before applying changes to a page, you would create a clone of the control, pass both the original control and the clone to this RegisterClone method, and then, when the changes are persisted to the tag, all meta: attributes are also persisted.

.NET Framework
Available since 2.0
Return to top