Namespace: System.Runtime.Remoting

The System.Runtime.Remoting namespace provides classes and interfaces that allow developers to create and configure distributed applications. Some of the more important classes of the System.Runtime.Remoting namespace are the RemotingConfiguration class, the RemotingServices class, and the ObjRef class.

The RemotingConfiguration class contains static methods for interfacing with configuration settings. The RemotingConfiguration.Configure method allows developers to configure the Remoting infrastructure through the use of XML formatted configuration files. The RemotingConfiguration class also contains several methods for client-end and server-end registration of client and server activated objects that reside on the server.

The RemotingServices class provides a number of methods to help in using and publishing remoted objects. The RemotingServices.Marshal method provides the functionality for storing all the relevant information required to activate and communicate with a remote object in an instance of the ObjRef class for later serialization and transmission to a remote location. The RemotingServices.Unmarshal method reverses this process, creating a proxy for a remote object that can be used by an application without regard for any remoting subdivisions.

The ObjRef class holds all the relevant information required to activate and communicate with a remote object. This class is a serializable representation of an object that is transmitted to a remote location using a channel, where it is unmarshaled (see RemotingServices.Unmarshal) and can be used to create a local proxy of the remoted object.

Members of System.Runtime.Remoting Namespace

Classes

Class	Description
class ActivatedClientTypeEntry	Holds values for an object type registered on the client end as a type that can be activated on the server.
class ActivatedServiceTypeEntry	Holds values for an object type registered on the service end as one that can be activated on request from a client.
class InternalRemotingServices	Reserved class for internal use only.
class ObjectHandle	Wraps marshal by value object references, allowing them to be returned through an indirection.
class ObjRef	Stores all relevant information required to generate a proxy in order to communicate with a remote object.
class RemotingConfiguration	Provides various static methods for configuring the remoting infrastructure.
class RemotingException	The exception that is thrown when something has gone wrong during remoting.
class RemotingServices	Provides several methods for using and publishing remoted objects and proxies. This class cannot be inherited.
class RemotingTimeoutException	The exception that is thrown when the server or the client cannot be reached for a previously specified period of time.
class ServerException	The exception that is thrown to communicate errors to the client when the client connects to non .NET Framework applications that cannot throw exceptions.
class SoapServices	Provides several methods for using and publishing remoted objects in SOAP format.
class TypeEntry	Implements a base class that holds the configuration information used to activate an instance of a remote type.
class WellKnownClientTypeEntry	Holds values for an object type registered on the client as a well-known type object (single call or singleton).
class WellKnownServiceTypeEntry	Holds values for an object type registered on the service end as a well-known type object (single call or singleton).

Interfaces

Interface	Description
interface IChannelInfo	Provides custom channel information that is carried along with the ObjRef.
interface IEnvoyInfo	Provides envoy information.
interface IObjectHandle	Defines the interface for unwrapping marshal by value objects from indirection.
interface IRemotingTypeInfo	Provides type information for an object.