MarshalByRefObject クラス

.NET Framework クラス ライブラリ リファレンス

MarshalByRefObject クラス

リモート処理をサポートするアプリケーションで、アプリケーション ドメイン境界を超えてオブジェクトにアクセスできるようにします。

名前空間: System
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

<SerializableAttribute> _
<ComVisibleAttribute(True)> _
Public MustInherit Class
 MarshalByRefObject

Visual Basic (使用法)

Dim instance As MarshalByRefObject

C#

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public abstract class MarshalByRefObject

C++

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public ref class MarshalByRefObject abstract

J#

/** @attribute SerializableAttribute() */ 
/** @attribute ComVisibleAttribute(true) */ 
public abstract class MarshalByRefObject

JScript

SerializableAttribute 
ComVisibleAttribute(true) 
public abstract class MarshalByRefObject

解説

アプリケーション ドメインとは、1 つ以上のアプリケーションが常駐するオペレーティング システム プロセスのパーティションです。同一のアプリケーション ドメインのオブジェクトは直接通信します。異なるアプリケーション ドメインのオブジェクトは、アプリケーション ドメインの境界を越えてオブジェクトのコピーを転送するか、メッセージを交換するためにプロキシを使用することにより通信します。

MarshalByRefObject は、プロキシを使用してメッセージを交換することにより、アプリケーション ドメインの境界を越えて通信するオブジェクトの基本クラスです。MarshalByRefObject から継承されないオブジェクトは、暗黙的に値渡しでマーシャリングされます。リモート アプリケーションが値渡しのオブジェクトを参照する場合、そのオブジェクトのコピーがアプリケーション ドメイン境界を越えて渡されます。

MarshalByRefObject オブジェクトは、ローカル アプリケーション ドメインの境界内では直接アクセスできます。リモート アプリケーション ドメインのアプリケーションが初めて MarshalByRefObject にアクセスするときに、プロキシはそのリモート アプリケーションに渡されます。プロキシでの以降の呼び出しは、ローカル アプリケーション ドメインに常駐するオブジェクトにマーシャリングされます。

アプリケーション ドメインの境界を越えて使用する型は MarshalByRefObject から継承する必要があります。そのメンバが作成されたアプリケーション ドメイン外では同メンバを使用できないため、オブジェクトの状態をコピーできません。

使用例

後でリモート処理で使用される MarshalByRefObject から派生したクラスを、次の例に示します。

Visual Basic

Imports System
Imports System.Runtime.Remoting
Imports System.Security.Permissions

Public Class SetObjectUriForMarshalTest
    
    Class TestClass
        Inherits MarshalByRefObject
    End Class

    <SecurityPermission(SecurityAction.LinkDemand)> _
    Public Shared Sub Main()
        Dim obj As TestClass = New
 TestClass()

        RemotingServices.SetObjectUriForMarshal(obj, "testUri")
        RemotingServices.Marshal(obj)

        Console.WriteLine(RemotingServices.GetObjectUri(obj))
    End Sub

End Class

C#

using System;
using System.Runtime.Remoting;
using System.Security.Permissions;

public class SetObjectUriForMarshalTest  {

    class TestClass : MarshalByRefObject {
    }

    [SecurityPermission(SecurityAction.LinkDemand)]
    public static void Main()
  {

        TestClass obj = new TestClass();    

        RemotingServices.SetObjectUriForMarshal(obj, "testUri");
        RemotingServices.Marshal(obj);

        Console.WriteLine(RemotingServices.GetObjectUri(obj));
    }
}

C++

using namespace System;
using namespace System::Runtime::Remoting;
using namespace System::Security::Permissions;

public ref class SetObjectUriForMarshalTest
{
public:
   ref class TestClass: public MarshalByRefObject{};

   [SecurityPermissionAttribute(SecurityAction::Demand, Flags=SecurityPermissionFlag::Infrastructure)]
   
   static void Main()
   {
      TestClass^ obj = gcnew TestClass;
      RemotingServices::SetObjectUriForMarshal( obj,  "testUri" );
      RemotingServices::Marshal(obj);
      Console::WriteLine( RemotingServices::GetObjectUri( obj ) );
   }

};

継承階層

System.Object
  System.MarshalByRefObject
     派生クラス

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
MarshalByRefObject メンバ
System 名前空間