RemotingServices.Marshal 方法

定义

命名空间:

System.Runtime.Remoting

程序集:

mscorlib.dll

将给定的 MarshalByRefObject 转换为 ObjRef 类的实例，可以将该实例序列化以便在应用程序域之间以及通过网络进行传输。

重载

Marshal(MarshalByRefObject)	接受 MarshalByRefObject，将其注册到远程处理基础结构，然后将其转换为 ObjRef 类的实例。
Marshal(MarshalByRefObject, String)	将给定的 MarshalByRefObject 转换为具有指定 URI 的 ObjRef 类的实例。
Marshal(MarshalByRefObject, String, Type)	接受 MarshalByRefObject，并将其转换为具有指定 URI 和提供的 ObjRef 的 Type 类的实例。

Marshal(MarshalByRefObject)

接受 MarshalByRefObject，将其注册到远程处理基础结构，然后将其转换为 ObjRef 类的实例。

public:
 static System::Runtime::Remoting::ObjRef ^ Marshal(MarshalByRefObject ^ Obj);

public static System.Runtime.Remoting.ObjRef Marshal (MarshalByRefObject Obj);

static member Marshal : MarshalByRefObject -> System.Runtime.Remoting.ObjRef

Public Shared Function Marshal (Obj As MarshalByRefObject) As ObjRef

参数

Obj

MarshalByRefObject

要转换的对象。

返回

ObjRef

ObjRef 类的一个实例，它表示 Obj 参数中指定的对象。

例外

RemotingException

Obj 参数是一个对象代理。

SecurityException

在调用堆栈上部，至少有一个调用方没有配置远程处理类型和通道的权限。

注解

是 ObjRef 用于跨应用程序域边界传输对象引用的对象的可序列化表示形式。 ObjRef为对象创建 称为封送处理。 ObjRef可以通过通道传输到另一个应用程序域， (可能在另一个进程或计算机上) 。 进入其他应用程序域后， ObjRef 必须分析 才能为对象创建代理，通常连接到实际对象。 此操作称为取消封送。

包含 ObjRef 描述 Type 被封送对象的 和 类的信息、唯一标识特定对象实例的 URI，以及有关如何访问对象所在的远程处理细分区的相关信息。

在封送处理期间，将使用来自当前线程的上下文，而不是创建对象时处于活动状态的上下文。 如果 URI 不是由 SetObjectUriForMarshal 方法显式设置的，则远程处理标识基础结构会自动生成该 URI。

由于以下两个原因之一，无法将 URI 与代理关联：URI 是在服务器端为其表示的对象生成的，或者对象是众所周知的，在这种情况下，URI 是已知的。 出于此原因，如果 Obj 参数是代理，则会引发异常。 对于自定义代理，由于透明代理被视为服务器对象，因此会放宽此限制。

另请参阅

• Uri
• RealProxy
• ObjRef
• 应用程序域

Marshal(MarshalByRefObject, String)

将给定的 MarshalByRefObject 转换为具有指定 URI 的 ObjRef 类的实例。

public:
 static System::Runtime::Remoting::ObjRef ^ Marshal(MarshalByRefObject ^ Obj, System::String ^ URI);

public static System.Runtime.Remoting.ObjRef Marshal (MarshalByRefObject Obj, string URI);

static member Marshal : MarshalByRefObject * string -> System.Runtime.Remoting.ObjRef

Public Shared Function Marshal (Obj As MarshalByRefObject, URI As String) As ObjRef

参数

Obj

MarshalByRefObject

要转换的对象。

URI

String

指定的 URI，使用它来初始化新 ObjRef。 可以为 null。

返回

ObjRef

ObjRef 类的一个实例，它表示 Obj 参数中指定的对象。

例外

RemotingException

Obj 是一个对象代理，URI 参数不为 null。

SecurityException

在调用堆栈上部，至少有一个调用方没有配置远程处理类型和通道的权限。

示例

下面的代码示例演示如何使用当前 Marshal 方法封送指定对象。

TcpChannel^ channel = gcnew TcpChannel( 9000 );
ChannelServices::RegisterChannel( channel );
SampleWellKnown ^ objectWellKnown = gcnew SampleWellKnown;

// After the channel is registered, the Object* needs to be registered
// with the remoting infrastructure.  So, Marshal is called.
ObjRef^ objrefWellKnown = RemotingServices::Marshal( objectWellKnown, "objectWellKnownUri" );
Console::WriteLine( "An instance of SampleWellKnown type is published at {0}.", objrefWellKnown->URI );
Console::WriteLine( "Press enter to unregister SampleWellKnown, so that it is no longer available on this channel." );
Console::ReadLine();
RemotingServices::Disconnect( objectWellKnown );
Console::WriteLine( "Press enter to end the server process." );
Console::ReadLine();

TcpChannel channel = new TcpChannel(9000);
ChannelServices.RegisterChannel(channel);

SampleWellKnown objectWellKnown = new SampleWellKnown();

// After the channel is registered, the object needs to be registered
// with the remoting infrastructure.  So, Marshal is called.
ObjRef objrefWellKnown = RemotingServices.Marshal(objectWellKnown, "objectWellKnownUri");
Console.WriteLine("An instance of SampleWellKnown type is published at {0}.", objrefWellKnown.URI);

Console.WriteLine("Press enter to unregister SampleWellKnown, so that it is no longer available on this channel.");
Console.ReadLine();
RemotingServices.Disconnect(objectWellKnown);

Console.WriteLine("Press enter to end the server process.");
Console.ReadLine();

Dim channel As New TcpChannel(9000)
ChannelServices.RegisterChannel(channel)

Dim objectWellKnown As New SampleWellKnown()
' After the channel is registered, the object needs to be registered
' with the remoting infrastructure.  So, Marshal is called.
Dim objrefWellKnown As ObjRef = RemotingServices.Marshal(objectWellKnown, "objectWellKnownUri")
Console.WriteLine("An instance of SampleWellKnown type is published at {0}.", objrefWellKnown.URI)

Console.WriteLine("Press enter to unregister SampleWellKnown, so that it is no longer available on this channel.")
Console.ReadLine()
RemotingServices.Disconnect(objectWellKnown)
Console.WriteLine("Press enter to end the server process.")
Console.ReadLine()

注解

是 ObjRef 用于跨应用程序域边界传输对象引用的对象的可序列化表示形式。 ObjRef为对象创建 称为封送处理。 ObjRef可以通过通道传输到另一个应用程序域， (可能在另一个进程或计算机上) 。 进入其他应用程序域后， ObjRef 必须分析 才能为对象创建代理，通常连接到实际对象。 此操作称为取消封送。

包含 ObjRef 描述 Type 被封送对象的 和 类的信息、唯一标识特定对象实例的 URI，以及有关如何访问对象所在的远程处理细分区的相关信息。

在封送处理期间，将使用来自当前线程的上下文，而不是创建对象时处于活动状态的上下文。

由于以下两个原因之一，无法将 URI 与代理关联：URI 是在服务器端为其表示的对象生成的，或者对象是众所周知的，在这种情况下，URI 是已知的。 出于此原因，如果 Obj 参数是代理，则会引发异常。 对于自定义代理，由于透明代理被视为服务器对象，因此会放宽此限制。

另请参阅

• Uri
• RealProxy
• ObjRef
• 应用程序域

Marshal(MarshalByRefObject, String, Type)

接受 MarshalByRefObject，并将其转换为具有指定 URI 和提供的 ObjRef 的 Type 类的实例。

public:
 static System::Runtime::Remoting::ObjRef ^ Marshal(MarshalByRefObject ^ Obj, System::String ^ ObjURI, Type ^ RequestedType);

public static System.Runtime.Remoting.ObjRef Marshal (MarshalByRefObject Obj, string ObjURI, Type RequestedType);

static member Marshal : MarshalByRefObject * string * Type -> System.Runtime.Remoting.ObjRef

Public Shared Function Marshal (Obj As MarshalByRefObject, ObjURI As String, RequestedType As Type) As ObjRef

参数

Obj

MarshalByRefObject

要转换为 ObjRef 的对象。

ObjURI

String

URI，使用它对 Obj 参数中指定的对象进行封送。 可以为 null。

RequestedType

Type

Obj 被封送为的 Type。 可以为 null。

返回

ObjRef

ObjRef 类的一个实例，它表示 Obj 参数中指定的对象。

例外

RemotingException

Obj 是远程对象的代理，ObjUri 参数不为 null。

SecurityException

在调用堆栈上部，至少有一个调用方没有配置远程处理类型和通道的权限。

注解

是 ObjRef 用于跨应用程序域边界传输对象引用的对象的可序列化表示形式。 ObjRef为对象创建 称为封送处理。 ObjRef可以通过通道传输到另一个应用程序域， (可能在另一个进程或计算机上) 。 进入其他应用程序域后， ObjRef 必须分析 才能为对象创建代理，通常连接到实际对象。 此操作称为取消封送。

包含 ObjRef 描述 Type 被封送对象的 和 类的信息、唯一标识特定对象实例的 URI，以及有关如何访问对象所在的远程处理细分区的相关信息。

远程处理基础结构使用指定的 Type 来限制公开的类型层次结构的范围。 例如，如果对象 A 派生自对象 B，该对象从对象 C 派生并调用，则客户端可以在 C 和 Marshal B 之间强制转换代理，但不能强制转换为 A。

在封送处理期间，将使用来自当前线程的上下文，而不是创建对象时处于活动状态的上下文。

由于以下两个原因之一，无法将 URI 与代理关联：URI 是在服务器端为其表示的对象生成的，或者对象是众所周知的，在这种情况下，URI 是已知的。 出于此原因，如果 Obj 参数是代理，则会引发异常。 对于自定义代理，由于透明代理被视为服务器对象，因此会放宽此限制。

另请参阅

• Uri
• RealProxy
• ObjRef
• 应用程序域