ITrackingHandlerとは何？わかりやすく解説 Weblio辞書

すべての辞書から再検索する

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

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

ITrackingHandler インターフェイス

実装オブジェクトに、リモート処理インフラストラクチャによって、オブジェクトとプロキシのマーシャリング、マーシャリング解除、および切断を通知する必要があることを示します。

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

Visual Basic (宣言)

<ComVisibleAttribute(True)> _
Public Interface ITrackingHandler

Visual Basic (使用法)

Dim instance As ITrackingHandler

[ComVisibleAttribute(true)] 
public interface ITrackingHandler

C++

[ComVisibleAttribute(true)] 
public interface class ITrackingHandler

/** @attribute ComVisibleAttribute(true) */ 
public interface ITrackingHandler

JScript

ComVisibleAttribute(true) 
public interface ITrackingHandler

解説

TrackingServices に登録されているすべてのオブジェクトは、現在の AppDomain 内のオブジェクトまたはプロキシがマーシャリング、マーシャリング解除、または切断されるときに、リモート処理によって呼び出されます。

切断できるのはオブジェクトだけです。切断がプロキシで呼び出されると、例外がスローされます。

メモ
このインターフェイスはリンク確認要求を行います。直前の呼び出し元がインターフェイスへの参照を通じて呼び出しを実行し、インフラストラクチャアクセス許可を持たない場合、SecurityException がスローされます。詳細については、「リンク確認要求」を参照してください。

使用例

ITrackingHandler インターフェイスのメソッドを実装して、リモート処理インフラストラクチャから通知を受け取る方法を次のコード例に示します。

このインターフェイスを実装する方法を次のコード例に示します。

using System;
using System.Runtime.Remoting;
using System.Runtime.Remoting.Channels;
using System.Runtime.Remoting.Services;


// Intercept marshal, unmarshal, and disconnect events for an object.
public class TrackingHandler : ITrackingHandler
{
    // Called when the tracked object is marshaled.

    [System.Security.Permissions.SecurityPermissionAttribute(
     System.Security.Permissions.SecurityAction.LinkDemand,
     Flags=System.Security.Permissions.SecurityPermissionFlag.Infrastructure)]
    public void MarshaledObject(Object obj,
 ObjRef objRef)
    {
        // Notify the user of the marshal event.
        Console.WriteLine("Tracking: An instance of {0} was marshaled.",
 
            obj.ToString());

        // Print the channel information.
        if (objRef.ChannelInfo != null)
        {
            // Iterate over ChannelData.
            foreach(object data in objRef.ChannelInfo.ChannelData)
            {
                if (data is ChannelDataStore)
                {
                    // Print the URIs from the ChannelDataStore objects.
                    string[] uris = ((ChannelDataStore)data).ChannelUris;
                    foreach(string uri in
 uris)
                        Console.WriteLine("ChannelUri: " + uri);
                }
            }
        }

        // Print the envoy information.
        if (objRef.EnvoyInfo != null)
            Console.WriteLine("EnvoyInfo: " + objRef.EnvoyInfo.ToString());

        // Print the type information.
        if (objRef.TypeInfo != null)
        {
            Console.WriteLine("TypeInfo: " + objRef.TypeInfo.ToString());
            Console.WriteLine("TypeName: " + objRef.TypeInfo.TypeName);
        }

        // Print the URI.
        if (objRef.URI != null)
            Console.WriteLine("URI: " + objRef.URI.ToString());
    }

    // Called when the tracked object is unmarshaled.
    [System.Security.Permissions.SecurityPermissionAttribute(
     System.Security.Permissions.SecurityAction.LinkDemand,
     Flags=System.Security.Permissions.SecurityPermissionFlag.Infrastructure)]
    public void UnmarshaledObject(Object obj,
 ObjRef objRef)
    {
        Console.WriteLine("Tracking: An instance of {0} was unmarshaled.",
 
            obj.ToString());
    }

    // Called when the tracked object is disconnected.
    [System.Security.Permissions.SecurityPermissionAttribute(
     System.Security.Permissions.SecurityAction.LinkDemand,
     Flags=System.Security.Permissions.SecurityPermissionFlag.Infrastructure)]
    public void DisconnectedObject(Object obj)
    {
        Console.WriteLine("Tracking: An instance of {0} was disconnected.",
 
            obj.ToString());
    }
}

このインターフェイスをサーバー上で実装する方法を次のコード例に示します。

using System;
using System.Runtime.Remoting;
using System.Runtime.Remoting.Channels;
using System.Runtime.Remoting.Channels.Tcp;
using System.Runtime.Remoting.Services;
using System.Security.Permissions;

public class Server
{
[SecurityPermission(SecurityAction.Demand)]
    public static void Main(string[]
 args)
    {
        // Register the TCP channel.
        TcpChannel channel = new TcpChannel(1234);
        ChannelServices.RegisterChannel(channel);

        // Register a tracking handler.
        ITrackingHandler handler1 = new TrackingHandler();
        TrackingServices.RegisterTrackingHandler(handler1);

        // Register a second handler.
        ITrackingHandler handler2 = new TrackingHandler();
        TrackingServices.RegisterTrackingHandler(handler2);

        // Get the number of currently registered handlers.
        Console.WriteLine("Registered tracking handlers: " + 
            TrackingServices.RegisteredHandlers.Length);

        // Remove the tracking handler from the registered handlers.
        TrackingServices.UnregisterTrackingHandler(handler2);
        Console.WriteLine("Registered tracking handlers: " + 
            TrackingServices.RegisteredHandlers.Length);

        // Create and marshal an object for remote invocation.
        RemoteService service = new RemoteService();
        ObjRef obj = RemotingServices.Marshal(service, "TcpService");

        // Wait for the user prompt.
        Console.WriteLine("\r\nPress ENTER to unmarshal the object.");
        Console.ReadLine();

        // Unmarshal the object.
        RemotingServices.Unmarshal(obj);

        // Wait for the user prompt.
        Console.WriteLine("Press ENTER to disconnect the object.");
        Console.ReadLine();

        // Disconnect the object.
        RemotingServices.Disconnect(service);
    }
}

このインターフェイスを前のコード例のサーバーに対するクライアントで実装する方法を次のコード例に示します。

using System;
using System.Diagnostics;
using System.Reflection;
using System.Runtime.Remoting;
using System.Runtime.Remoting.Channels;
using System.Runtime.Remoting.Channels.Tcp;

public class Client
{
    public static void Main(string[]
 args)
    {
        // Register the TCP channel.
        ChannelServices.RegisterChannel(new TcpChannel());

        // Register the client for the remote object.
        WellKnownClientTypeEntry remoteType = new WellKnownClientTypeEntry(
            typeof(RemoteService),"tcp://localhost:1234/TcpService");
        RemotingConfiguration.RegisterWellKnownClientType(remoteType);

        // Create an instance of the remote object.
        RemoteService service = new RemoteService(); 

        // Invoke a method on the remote object.
        service.Hello("world");
        Console.WriteLine("Hello invoked on server.");
    }
}

サーバーとクライアントによって使用されるリモートオブジェクトを次のコード例に示します。

using System;
using System.Diagnostics;
using System.Runtime.Remoting;
using System.Runtime.Remoting.Channels;

// Remote object.
public class RemoteService : MarshalByRefObject
{
    private DateTime startTime;

    public RemoteService()
    {
        // Notify the user that the constructor was invoked.
        Console.WriteLine("Constructor invoked.");
        startTime = DateTime.Now;
    }

    ~RemoteService()
    {
        // Notify the user that the destructor was invoked.
        TimeSpan elapsedTime = 
            new TimeSpan(DateTime.Now.Ticks - startTime.Ticks);
        Console.WriteLine("Destructor invoked after " + 
            elapsedTime.ToString() + " seconds.");
    }

    public void Hello(string
 name)
    {
        // Print a simple message.
        Console.WriteLine("Hello, " + name);
    }
}

.NET Framework のセキュリティ

SecurityPermission (インフラストラクチャコードを操作するために必要なアクセス許可)。要求値 : SecurityAction.LinkDemand; アクセス許可値 : SecurityPermissionFlag.Infrastructure

プラットフォーム

バージョン情報

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

参照

関連項目
ITrackingHandler メンバ
System.Runtime.Remoting.Services 名前空間

ITrackingHandler メソッド

パブリックメソッドパブリックメソッド

	名前	説明
	DisconnectedObject	オブジェクトがプロキシから切断されたことを現在のインスタンスに通知します。
	MarshaledObject	オブジェクトがマーシャリングされたことを現在のインスタンスに通知します。
	UnmarshaledObject	オブジェクトがマーシャリング解除されたことを現在のインスタンスに通知します。

参照

ITrackingHandler メンバ

ITrackingHandler データ型で公開されるメンバを以下の表に示します。

パブリックメソッド

	名前	説明
	DisconnectedObject	オブジェクトがプロキシから切断されたことを現在のインスタンスに通知します。
	MarshaledObject	オブジェクトがマーシャリングされたことを現在のインスタンスに通知します。
	UnmarshaledObject	オブジェクトがマーシャリング解除されたことを現在のインスタンスに通知します。