ArcObjects Library Reference (System)  

IObjectCopy Interface

Provides access to members to copy objects by value. The object must support IPersistStream to be copied.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Description

Provides a mechanism to duplicate an object using an objects persistence mechanism (IPersistStream). The objects state is written to a temporary stream and then "rehydrated" from that stream into a new instance of the object. This process is also known as a deep clone as an object will also duplicate all sub objects that it contains. Even if the object supports IClone, you may still want to use ObjectCopy since it does a full copy or 'deep clone' of the object.

Members

Description
Method Copy Obtains a new object which is a copy of the input object.
Method Overwrite Overwrites the object with the contents of input object.

CoClasses that implement IObjectCopy

CoClasses and Classes Description
ObjectCopy CoClass to copy objects by value.

.NET Samples

Clonable object (Code Files: ClonableObjClass) | Copy the PageLayoutControl focus map and overwrite the MapControl map (Code Files: CopyFocusMap) | Triangle graphic element (Code Files: TriangleElementClass) |

.NET Related Topics

Implementing cloning |