TcpClientChannel Classe

Definição

public ref class TcpClientChannel : System::Runtime::Remoting::Channels::IChannelSender

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

public class TcpClientChannel : System.Runtime.Remoting.Channels.IChannelSender

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

type TcpClientChannel = class
    interface IChannelSender
    interface IChannel

type TcpClientChannel = class
    interface IChannelSender
    interface IChannel
    interface ISecurableChannel

Public Class TcpClientChannel
Implements IChannelSender

Public Class TcpClientChannel
Implements IChannelSender, ISecurableChannel

Herança

Object

TcpClientChannel

Implementações

IChannel IChannelSender ISecurableChannel

Exemplos

O seguinte exemplo de código mostra o uso da TcpClientChannel classe para chamar um tipo remoto.

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

using namespace System;
using namespace System::Runtime::Remoting;
using namespace System::Runtime::Remoting::Channels;
using namespace System::Runtime::Remoting::Channels::Tcp;
int main()
{
   
   // Set up a client channel.
   TcpClientChannel^ clientChannel = gcnew TcpClientChannel;
   ChannelServices::RegisterChannel( clientChannel );
   
   // Show the name and priority of the channel.
   Console::WriteLine( "Channel Name: {0}", clientChannel->ChannelName );
   Console::WriteLine( "Channel Priority: {0}", clientChannel->ChannelPriority );
   
   // Obtain a proxy for a remote object.
   RemotingConfiguration::RegisterWellKnownClientType( Remotable::typeid, "tcp://localhost:9090/Remotable.rem" );
   
   // Call a method on the object.
   Remotable ^ remoteObject = gcnew Remotable;
   Console::WriteLine( remoteObject->GetCount() );
}

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

public class Client
{
    public static void Main()
    {

        // Set up a client channel.
        TcpClientChannel clientChannel = new TcpClientChannel();
        ChannelServices.RegisterChannel(clientChannel);

        // Show the name and priority of the channel.
        Console.WriteLine("Channel Name: {0}", clientChannel.ChannelName);
        Console.WriteLine("Channel Priority: {0}", clientChannel.ChannelPriority);

        // Obtain a proxy for a remote object.
        RemotingConfiguration.RegisterWellKnownClientType(
            typeof(Remotable), "tcp://localhost:9090/Remotable.rem"
        );

        // Call a method on the object.
        Remotable remoteObject = new Remotable();
        Console.WriteLine( remoteObject.GetCount() );
    }
}

O tipo remoto chamado no exemplo acima é definido pelo seguinte código.

using namespace System;
using namespace System::Runtime::Remoting;

public ref class Remotable: public MarshalByRefObject
{
private:
   int callCount;

public:
   Remotable()
      : callCount( 0 )
   {}

   int GetCount()
   {
      callCount++;
      return (callCount);
   }
};

using System;
using System.Runtime.Remoting;

public class Remotable : MarshalByRefObject
{

    private int callCount = 0;

    public int GetCount()
    {
        callCount++;
        return(callCount);
    }
}

Observações

Os canais transportam mensagens através de fronteiras remotas (por exemplo, computadores ou domínios de aplicação). A TcpClientChannel classe transporta mensagens usando o protocolo TCP.

Os canais são usados pela infraestrutura remota do .NET Framework para transportar chamadas remotas. Quando um cliente faz uma chamada para um objeto remoto, a chamada é serializada numa mensagem enviada por um canal cliente e recebida por um canal servidor. Depois, é desserializado e processado. Quaisquer valores devolvidos são transmitidos pelo canal do servidor e recebidos pelo canal cliente.

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 TcpClientChannel são passadas.

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

Um TcpClientChannel 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 TcpClientChannel construtor). Para uma lista destas propriedades de configuração, consulte a documentação para TcpClientChannel.