IpcClientChannel Classe

Definição

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

Herança

Object

IpcClientChannel

Implementações

IChannel IChannelSender ISecurableChannel

Exemplos

O exemplo de código seguinte mostra como usar a IpcClientChannel classe.

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

O código anterior utiliza o seguinte objeto remoto.

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

Para um exemplo de servidor que expõe este objeto remotamente, veja IpcServerChannel.

Observações

Os canais são utilizados pela infraestrutura remota do .NET Framework para transportar chamadas remotas. Quando um cliente chama um objeto remoto, a chamada é serializada numa mensagem enviada por um canal cliente e recebida por um canal servidor. Após a receção da mensagem, esta é desserializada e processada. Quaisquer valores devolvidos são transmitidos pelo canal do servidor e recebidos pelo canal cliente.

A classe IpcClientChannel utiliza o sistema de comunicação entre processos (IPC) Windows para transportar mensagens entre domínios de aplicação no mesmo computador. Ao comunicar entre domínios de aplicação no mesmo computador, o canal IPC é muito mais rápido do que os canais TCP ou HTTP.

Para realizar um processamento adicional de mensagens do lado do cliente, pode especificar uma implementação da IClientChannelSinkProvider interface através da qual todas as mensagens processadas pelo IpcClientChannel objeto serão passadas.

Por defeito, a IpcClientChannel classe utiliza um formatador binário para serializar todas as mensagens.

Um IpcClientChannel objeto tem propriedades de configuração associadas que podem ser definidas em tempo de execução, seja num ficheiro de configuração (invocando o método estático RemotingConfiguration.Configure ) ou programaticamente (passando uma IDictionary coleção ao IpcClientChannel construtor). Para uma lista destas propriedades de configuração, consulte a documentação do IpcClientChannel construtor.