TrackingServices Klasa

Definicja

Przestrzeń nazw:

System.Runtime.Remoting.Services

Zestaw:

mscorlib.dll

Zapewnia sposób rejestrowania, wyrejestrowania i uzyskiwania listy procedur obsługi śledzenia.

public ref class TrackingServices

[System.Runtime.InteropServices.ComVisible(true)]
[System.Security.SecurityCritical]
public class TrackingServices

[<System.Runtime.InteropServices.ComVisible(true)>]
[<System.Security.SecurityCritical>]
type TrackingServices = class

Public Class TrackingServices

Dziedziczenie

Object

TrackingServices

Atrybuty

ComVisibleAttribute SecurityCriticalAttribute

Przykłady

Poniższy przykład kodu pokazuje, jak używać metod TrackingServices klasy do rejestrowania i wyrejestrowania procedur obsługi śledzenia.

W poniższym przykładzie kodu pokazano, jak zaimplementować procedurę obsługi śledzenia.

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.

    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.
    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.
    public void DisconnectedObject(Object obj)
    {
        Console.WriteLine("Tracking: An instance of {0} was disconnected.", 
            obj.ToString());
    }
}

Poniższy przykład kodu pokazuje, jak zaimplementować tę klasę na serwerze.

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

public class Server
{
    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);
    }
}

Poniższy przykład kodu pokazuje, jak zaimplementować tę klasę na kliencie serwera w poprzednim przykładzie kodu.

using System;
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.");
    }
}

Poniższy przykład kodu przedstawia obiekt zdalny używany przez serwer i klienta.

using System;

// 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 finalizer was invoked.
        TimeSpan elapsedTime = 
            new TimeSpan(DateTime.Now.Ticks - startTime.Ticks);
        Console.WriteLine("Finalizer invoked after " + 
            elapsedTime.ToString() + " seconds.");
    }

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

Uwagi

Programy obsługi śledzenia to obiekty implementujące ITrackingHandler interfejs, które wskazują, że muszą być powiadamiane za każdym razem, gdy marszałek infrastruktury komunikacji sieciowej, unmarshals lub rozłącza obiekt lub serwer proxy. Każdy zarejestrowany TrackingServices obiekt jest wywoływany przez komunikacji zdalną, gdy obiekt lub serwer proxy w bieżącej wersji AppDomain są marshalowane, niemarshalowane lub rozłączone.

Wszystkie metody w TrackingServices klasie są statyczne i działają na programach obsługi śledzenia w bieżącym obiekcie AppDomain.

Uwaga

Ta klasa sprawia, że zapotrzebowanie na łącza. Wyjątek SecurityException jest zgłaszany, jeśli bezpośredni obiekt wywołujący nie ma uprawnień infrastruktury. Aby uzyskać więcej informacji, zobacz Link Demands (Żądania linków ).

Konstruktory

TrackingServices()

Tworzy wystąpienie klasy TrackingServices.

Właściwości

RegisteredHandlers

Pobiera tablicę procedur obsługi śledzenia, które są obecnie zarejestrowane TrackingServices w bieżącym elemencie AppDomain.

Metody

Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
RegisterTrackingHandler(ITrackingHandler)	Rejestruje nową procedurę obsługi śledzenia za pomocą polecenia TrackingServices.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)
UnregisterTrackingHandler(ITrackingHandler)	Wyrejestrowuje określoną procedurę obsługi śledzenia z TrackingServicesprogramu .

Zobacz też

• ITrackingHandler