System.Runtime.Remoting
TOC
Collapse the table of content
Expand the table of content

System.Runtime.Remoting Namespace

 

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.

ClassDescription
System_CAPS_pubclassActivatedClientTypeEntry

Holds values for an object type registered on the client end as a type that can be activated on the server.

System_CAPS_pubclassActivatedServiceTypeEntry

Holds values for an object type registered on the service end as one that can be activated on request from a client.

System_CAPS_pubclassInternalRemotingServices

Defines utility methods for use by the .NET Framework remoting infrastructure.

System_CAPS_pubclassObjectHandle

Wraps marshal-by-value object references, allowing them to be returned through an indirection.

System_CAPS_pubclassObjRef

Stores all relevant information required to generate a proxy in order to communicate with a remote object.

System_CAPS_pubclassRemotingConfiguration

Provides various static methods for configuring the remoting infrastructure.

System_CAPS_pubclassRemotingException

The exception that is thrown when something has gone wrong during remoting.

System_CAPS_pubclassRemotingServices

Provides several methods for using and publishing remoted objects and proxies. This class cannot be inherited.

System_CAPS_pubclassRemotingTimeoutException

The exception that is thrown when the server or the client cannot be reached for a previously specified period of time.

System_CAPS_pubclassServerException

The exception that is thrown to communicate errors to the client when the client connects to non-.NET Framework applications that cannot throw exceptions.

System_CAPS_pubclassSoapServices

Provides several methods for using and publishing remoted objects in SOAP format.

System_CAPS_pubclassTypeEntry

Implements a base class that holds the configuration information used to activate an instance of a remote type.

System_CAPS_pubclassWellKnownClientTypeEntry

Holds values for an object type registered on the client as a server-activated type (single call or singleton).

System_CAPS_pubclassWellKnownServiceTypeEntry

Holds values for an object type registered on the service end as a server-activated type object (single call or singleton).

InterfaceDescription
System_CAPS_pubinterfaceIChannelInfo

Provides custom channel information that is carried along with the ObjRef.

System_CAPS_pubinterfaceIEnvoyInfo

Provides envoy information.

System_CAPS_pubinterfaceIObjectHandle

Defines the interface for unwrapping marshal-by-value objects from indirection.

System_CAPS_pubinterfaceIRemotingTypeInfo

Provides type information for an object.

EnumerationDescription
System_CAPS_pubenumCustomErrorsModes

Specifies how custom errors are handled.

System_CAPS_pubenumWellKnownObjectMode

Defines how well-known objects are activated.

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 Unmarshal) and can be used to create a local proxy of the remoted object.

System_CAPS_noteNote

Marshal-by-reference objects (MBRs) do not reside in memory forever. Instead, unless the type overrides MarshalByRefObject.InitializeLifetimeService to control its own lifetime policies, each MBR has a finite lifetime before the .NET Framework remoting system begins the process of deleting it and reclaiming the memory. For more information, see Lifetime Leases.

Return to top
Show:
© 2016 Microsoft