RemotingServices Class

Definition

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

public ref class RemotingServices sealed
public ref class RemotingServices abstract sealed
public sealed class RemotingServices
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class RemotingServices
[System.Runtime.InteropServices.ComVisible(true)]
public static class RemotingServices
type RemotingServices = class
[<System.Runtime.InteropServices.ComVisible(true)>]
type RemotingServices = class
Public NotInheritable Class RemotingServices
Public Class RemotingServices
Inheritance
RemotingServices
Attributes

Remarks

Unless you are a service provider dealing with issues such as activation, lifetime management, or transactions, you do not need to distinguish between proxy references and object references. The remoting infrastructure uses transparent proxies that give the impression that the remote objects reside in the client's space. Proxies achieve this by forwarding calls made on them to the real objects at remote locations.

Methods

Connect(Type, String)

Creates a proxy for a well-known object, given the Type and URL.

Connect(Type, String, Object)

Creates a proxy for a well-known object, given the Type, URL, and channel-specific data.

Disconnect(MarshalByRefObject)

Stops an object from receiving any further messages through the registered remoting channels.

ExecuteMessage(MarshalByRefObject, IMethodCallMessage)

Connects to the specified remote object, and executes the provided IMethodCallMessage on it.

GetEnvoyChainForProxy(MarshalByRefObject)

Returns a chain of envoy sinks that should be used when sending messages to the remote object represented by the specified proxy.

GetLifetimeService(MarshalByRefObject)

Returns a lifetime service object that controls the lifetime policy of the specified object.

GetMethodBaseFromMethodMessage(IMethodMessage)

Returns the method base from the given IMethodMessage.

GetObjectData(Object, SerializationInfo, StreamingContext)

Serializes the specified marshal by reference object into the provided SerializationInfo.

GetObjectUri(MarshalByRefObject)

Retrieves the URI for the specified object.

GetObjRefForProxy(MarshalByRefObject)

Returns the ObjRef that represents the remote object from the specified proxy.

GetRealProxy(Object)

Returns the real proxy backing the specified transparent proxy.

GetServerTypeForUri(String)

Returns the Type of the object with the specified URI.

GetSessionIdForMethodMessage(IMethodMessage)

Retrieves a session ID for a message.

IsMethodOverloaded(IMethodMessage)

Returns a Boolean value that indicates whether the method in the given message is overloaded.

IsObjectOutOfAppDomain(Object)

Returns a Boolean value that indicates whether the object specified by the given transparent proxy is contained in a different application domain than the object that called the current method.

IsObjectOutOfContext(Object)

Returns a Boolean value that indicates whether the object represented by the given proxy is contained in a different context than the object that called the current method.

IsOneWay(MethodBase)

Returns a Boolean value that indicates whether the client that called the method specified in the given message is waiting for the server to finish processing the method before continuing execution.

IsTransparentProxy(Object)

Returns a Boolean value that indicates whether the given object is a transparent proxy or a real object.

LogRemotingStage(Int32)
Obsolete.

Logs the stage in a remoting exchange to an external debugger.

Marshal(MarshalByRefObject)

Takes a MarshalByRefObject, registers it with the remoting infrastructure, and converts it into an instance of the ObjRef class.

Marshal(MarshalByRefObject, String)

Converts the given MarshalByRefObject into an instance of the ObjRef class with the specified URI.

Marshal(MarshalByRefObject, String, Type)

Takes a MarshalByRefObject and converts it into an instance of the ObjRef class with the specified URI, and the provided Type.

SetObjectUriForMarshal(MarshalByRefObject, String)

Sets the URI for the subsequent call to the Marshal(MarshalByRefObject) method.

Unmarshal(ObjRef)

Takes a ObjRef and creates a proxy object out of it.

Unmarshal(ObjRef, Boolean)

Takes a ObjRef and creates a proxy object out of it, refining it to the type on the server.

Applies to