System.Runtime.Remoting.RemotingServices.Unmarshal Method

Takes a System.Runtime.Remoting.ObjRef and creates a proxy object out of it.

Syntax

public static object Unmarshal (ObjRef objectRef)

Parameters

objectRef
The System.Runtime.Remoting.ObjRef that represents the remote object for which the proxy is being created.

Returns

A proxy to the object that the given System.Runtime.Remoting.ObjRef represents.

Remarks

A System.Runtime.Remoting.ObjRef is a serializable representation of an object used to transfer an object reference across an application domain boundary. Creating a System.Runtime.Remoting.ObjRef for an object is known as marshaling. The System.Runtime.Remoting.ObjRef can be transferred through a channel into another application domain (possibly on another process or computer). Once in the other application domain, the System.Runtime.Remoting.ObjRef must be parsed to create a proxy for the object, generally connected to the real object. This operation is known as unmarshaling. During unmarshaling, the System.Runtime.Remoting.ObjRef is parsed to extract the method information of the remote object and both the transparent proxy and System.Runtime.Remoting.Proxies.RealProxy objects are created. The content of the parsed System.Runtime.Remoting.ObjRef is added to the transparent proxy before the transparent proxy is registered with the common language runtime.

A System.Runtime.Remoting.ObjRef contains information that describes the Type and class of the object being marshaled, a URI that uniquely identifies the specific object instance, and communication related information about how to reach the remoting subdivision where the object is located.

Requirements

Namespace: System.Runtime.Remoting
Assembly: mscorlib (in mscorlib.dll)
Assembly Versions: 1.0.5000.0, 2.0.0.0, 4.0.0.0