RemotingServices.SetObjectUriForMarshal メソッド

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

RemotingServices.SetObjectUriForMarshal メソッド

Marshal メソッドへの後続の呼び出しに対して URI を設定します。

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

Visual Basic (宣言)

Public Shared Sub SetObjectUriForMarshal
 ( _
    obj As MarshalByRefObject, _
    uri As String _
)

Visual Basic (使用法)

Dim obj As MarshalByRefObject
Dim uri As String

RemotingServices.SetObjectUriForMarshal(obj, uri)

C#

public static void SetObjectUriForMarshal
 (
    MarshalByRefObject obj,
    string uri
)

C++

public:
static void SetObjectUriForMarshal (
    MarshalByRefObject^ obj, 
    String^ uri
)

J#

public static void SetObjectUriForMarshal
 (
    MarshalByRefObject obj, 
    String uri
)

JScript

public static function SetObjectUriForMarshal
 (
    obj : MarshalByRefObject, 
    uri : String
)

パラメータ

obj

URI を設定する対象となるオブジェクト。

uri

指定したオブジェクトに割り当てる URI。

例外

例外の種類	条件
RemotingException	obj がローカル オブジェクトではありません。既にマーシャリングされています。または、現在のメソッドが既に呼び出されています。
SecurityException	コールスタックの上位にある 1 つ以上の呼び出し元に、リモート処理の型とチャネルを構成するためのアクセス許可がありません。

解説

特定のオブジェクトをマーシャリングする場合、現在のメソッドで設定された URI が使用されます。

マーシャリング後、指定したオブジェクトの URI は、現在の AppDomain の Guid に追加された uri パラメータの文字列に設定されます。

現在のアプリケーションが HTTP ポートで待機している場合は、uri パラメータで指定した文字列と現在の AppDomain の Guid に追加された uri 文字列の両方が、指定したオブジェクトに送信されます。たとえば、アプリケーションが HTTP ポート 9000 で待機している場合は、http://localhost:9000/objectUri と http://localhost:9000/<appdomainguid>/objectUri の両方が obj パラメータで指定したオブジェクトに送信されます。

使用例

指定したオブジェクトをマーシャリングするときに Marshal メソッドで使用する URI を設定する方法のコード例を次に示します。

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 ) );
   }

};

.NET Framework のセキュリティ

• SecurityPermission  (リモート処理インフラストラクチャを構成するために必要なアクセス許可)要求値 : SecurityAction.Demand; アクセス許可値 : SecurityPermissionFlag.RemotingConfiguration

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

参照

関連項目
RemotingServices クラス
RemotingServices メンバ
System.Runtime.Remoting 名前空間
Uri
Guid