ObjectHandle.Unwrap メソッドとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

ObjectHandle.Unwrap メソッド

ラップされたオブジェクトを返します。

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

Visual Basic (宣言)

Public Function Unwrap As
 Object

Visual Basic (使用法)

Dim instance As ObjectHandle
Dim returnValue As Object

returnValue = instance.Unwrap

public Object Unwrap ()

C++

public:
virtual Object^ Unwrap () sealed

public final Object Unwrap ()

JScript

public final function Unwrap () : Object

戻り値
ラップされたオブジェクト。

解説

呼び出し時の注意 ObjectHandle は、リモート処理有効期間サービスによって追跡されるリモート MarshalByRefObject です。現在のメソッドへの呼び出しは、ObjectHandle の有効期間リースが経過していると失敗する可能性があります。

使用例

別の AppDomain 内のオブジェクトをアクティブにし、Unwrap メソッドを使用してこのオブジェクトへのプロキシを取得して、このプロキシを使用してリモートオブジェクトにアクセスする方法を、次のコード例に示します。

Visual Basic

' Creates an instance of MyType defined in the assembly called ObjectHandleAssembly.
Dim obj As ObjectHandle = domain.CreateInstance("ObjectHandleAssembly",
 "MyType")

' Unwrapps the proxy to the MyType object created in the other AppDomain.
Dim testObj As MyType = CType(obj.Unwrap(),
 MyType)

If RemotingServices.IsTransparentProxy(testObj) Then
   Console.WriteLine("The unwrapped object is a proxy.")
Else
   Console.WriteLine("The unwrapped object is not a proxy!")
End If 
Console.WriteLine("")
Console.Write("Calling a method on the object located in an AppDomain
 with the hash code ")
Console.WriteLine(testObj.GetAppDomainHashCode())

// Creates an instance of MyType defined in the assembly called ObjectHandleAssembly.
ObjectHandle obj = domain.CreateInstance("ObjectHandleAssembly", "MyType");

// Unwrapps the proxy to the MyType object created in the other AppDomain.
MyType testObj = (MyType)obj.Unwrap();

if(RemotingServices.IsTransparentProxy(testObj))
   Console.WriteLine("The unwrapped object is a proxy.");
else
   Console.WriteLine("The unwrapped object is not a proxy!");    

Console.WriteLine("");
Console.Write("Calling a method on the object located in
 an AppDomain with the hash code ");
Console.WriteLine(testObj.GetAppDomainHashCode());

C++

// Creates an instance of MyType defined in the assembly called ObjectHandleAssembly.
ObjectHandle^ obj = domain->CreateInstance( "ObjectHandleAssembly",
 "MyType" );

// Unwraps the proxy to the MyType object created in the other AppDomain.
MyType^ testObj = dynamic_cast<MyType^>(obj->Unwrap());
if ( RemotingServices::IsTransparentProxy( testObj ) )
   Console::WriteLine( "The unwrapped object is a proxy." );
else
   Console::WriteLine( "The unwrapped object is not a proxy!" );

Console::WriteLine( "" );
Console::Write( "Calling a method on the object located in
 an AppDomain with the hash code " );
Console::WriteLine( testObj->GetAppDomainHashCode() );