ICloneable Interface
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Supports cloning, which creates a new instance of a class with the same value as an existing instance.
public interface class ICloneablepublic interface ICloneable[System.Runtime.InteropServices.ComVisible(true)]
public interface ICloneabletype ICloneable = interface[<System.Runtime.InteropServices.ComVisible(true)>]
type ICloneable = interfacePublic Interface ICloneable- Derived
- Attributes
Remarks
The ICloneable interface enables you to provide a customized implementation that creates a copy of an existing object. The ICloneable interface contains one member, the Clone method, which is intended to provide cloning support beyond that supplied by Object.MemberwiseClone. For more information about cloning, deep versus shallow copies, and examples, see the Object.MemberwiseClone method.
Notes to Implementers
The ICloneable interface simply requires that your implementation of the Clone() method return a copy of the current object instance. It does not specify whether the cloning operation performs a deep copy, a shallow copy, or something in between. Nor does it require all property values of the original instance to be copied to the new instance. For example, the Clone() method performs a shallow copy of all properties except the IsReadOnly property; it always sets this property value to false in the cloned object. Because callers of Clone() cannot depend on the method performing a predictable cloning operation, we recommend that ICloneable not be implemented in public APIs.
Methods
| Clone() |
Creates a new object that is a copy of the current instance. |
