IpcClientChannel Klas

Definitie

public ref class IpcClientChannel : System::Runtime::Remoting::Channels::IChannelSender, System::Runtime::Remoting::Channels::ISecurableChannel

public class IpcClientChannel : System.Runtime.Remoting.Channels.IChannelSender, System.Runtime.Remoting.Channels.ISecurableChannel

type IpcClientChannel = class
    interface IChannelSender
    interface IChannel
    interface ISecurableChannel

Public Class IpcClientChannel
Implements IChannelSender, ISecurableChannel

Overname

Object

IpcClientChannel

Implementeringen

IChannel IChannelSender ISecurableChannel

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de IpcClientChannel klasse gebruikt.

#using <System.Runtime.Remoting.dll>
#using <System.dll>
#using <Counter.dll>

using namespace System;
using namespace System::Runtime::Remoting;
using namespace System::Runtime::Remoting::Channels;
using namespace System::Runtime::Remoting::Channels::Ipc;

public ref class Client
{
public:
   void ClientTest()
   {
      IpcClientChannel^ clientChannel = gcnew IpcClientChannel;
      ChannelServices::RegisterChannel( clientChannel );

      RemotingConfiguration::RegisterWellKnownClientType( Counter::typeid, L"ipc://remote/counter" );
      Counter^ counter = gcnew Counter;
      Console::WriteLine( L"This is call number {0}.", counter->Count );
   }
};

int main()
{
   Client^ c = gcnew Client;
   c->ClientTest();
}

using System;
using System.Runtime.Remoting;
using System.Runtime.Remoting.Channels;
using System.Runtime.Remoting.Channels.Ipc;

public class Client
{
    public static void Main ()
    {
        IpcClientChannel clientChannel = new IpcClientChannel();
        ChannelServices.RegisterChannel(clientChannel);

        RemotingConfiguration.RegisterWellKnownClientType( typeof(Counter) , "ipc://remote/counter" );

        Counter counter = new Counter();
        Console.WriteLine("This is call number {0}.", counter.Count);
    }
}

De voorgaande code maakt gebruik van het volgende externe object.

using namespace System;
public ref class Counter: public MarshalByRefObject
{
private:
   int count;

public:
   Counter()
   {
      count = 0;
   }

   property int Count 
   {
      int get()
      {
         return (count)++;
      }
   }
};

using System;

public class Counter : MarshalByRefObject {

  private int count = 0;

  public int Count { get {
    return(count++);
  } }
}

Zie voor een voorbeeld van een server die dit object extern IpcServerChannelbeschikbaar maakt.

Opmerkingen

Kanalen worden gebruikt door de externe infrastructuur van .NET Framework voor het transport van externe aanroepen. Wanneer een client een extern object aanroept, wordt de aanroep geserialiseerd in een bericht dat wordt verzonden door een clientkanaal en wordt ontvangen door een serverkanaal. Nadat het bericht is ontvangen, wordt het gedeserialiseerd en verwerkt. Geretourneerde waarden worden verzonden door het serverkanaal en ontvangen door het clientkanaal.

De klasse IpcClientChannel maakt gebruik van het Windows IPC-systeem (Interprocess Communication) om berichten tussen toepassingsdomeinen op dezelfde computer te transporteren. Wanneer u communiceert tussen toepassingsdomeinen op dezelfde computer, is het IPC-kanaal veel sneller dan de TCP- of HTTP-kanalen.

Als u extra verwerking van berichten aan de clientzijde wilt uitvoeren, kunt u een implementatie van de IClientChannelSinkProvider interface opgeven waarmee alle berichten die door het IpcClientChannel object worden verwerkt, worden doorgegeven.

De klasse maakt standaard IpcClientChannel gebruik van een binaire formatter om alle berichten te serialiseren.

Een IpcClientChannel object heeft configuratie-eigenschappen die tijdens runtime kunnen worden ingesteld in een configuratiebestand (door de statische RemotingConfiguration.Configure methode aan te roepen) of programmatisch (door een IDictionary verzameling door te geven aan de IpcClientChannel constructor). Zie de documentatie voor de IpcClientChannel constructor voor een lijst met deze configuratie-eigenschappen.