MarshalByRefObject.MemberwiseClone(Boolean) Method
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.
Creates a shallow copy of the current MarshalByRefObject object.
protected:
MarshalByRefObject ^ MemberwiseClone(bool cloneIdentity);protected MarshalByRefObject MemberwiseClone (bool cloneIdentity);override this.MemberwiseClone : bool -> MarshalByRefObjectProtected Function MemberwiseClone (cloneIdentity As Boolean) As MarshalByRefObjectParameters
- cloneIdentity
- Boolean
false to delete the current MarshalByRefObject object's identity, which will cause the object to be assigned a new identity when it is marshaled across a remoting boundary. A value of false is usually appropriate. true to copy the current MarshalByRefObject object's identity to its clone, which will cause remoting client calls to be routed to the remote server object.
Returns
A shallow copy of the current MarshalByRefObject object.
Remarks
The MemberwiseClone(Boolean) method creates a shallow copy by creating a new MarshalByRefObject object, and then copying the nonstatic fields of the current MarshalByRefObject object to the new object. If a field is a value type, a bit-by-bit copy of the field is performed. If a field is a reference type, the reference is copied but the referred object is not; therefore, the original object and its clone refer to the same object.
For example, consider a MarshalByRefObject object called X that references objects A and B. Object B, in turn, references object C. A shallow copy of X creates new object X2 that also references objects A and B. In contrast, a deep copy of X creates a new object X2 that references the new objects A2 and B2, which are copies of A and B. B2, in turn, references the new object C2, which is a copy C. Use a class that implements the ICloneable interface to perform a deep or shallow copy of an object.
The identity of a MarshalByRefObject object is defined as the remote server object that is the target of a remoting client call. By default, the memberwise clone of a MarshalByRefObject object has the same identity as the original object, which is typically not the correct behavior for clones of server-side objects that are marshaled across a remoting boundary to the client side. Specify false, which is usually appropriate, to delete the identity of the clone and cause a new identity to be assigned when the clone is marshaled across a remoting boundary, or true to cause the clone to retain the identity of the original MarshalByRefObject object. The MemberwiseClone(Boolean) method is intended to be used by developers implementing remote server objects.
