TcpClientChannel Třída

Definice

Obor názvů:

System.Runtime.Remoting.Channels.Tcp

Sestavení:

System.Runtime.Remoting.dll

Pro vzdálená volání implementuje klientský kanál, který k přenosu zpráv používá protokol TCP.

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

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

type TcpClientChannel = class
    interface IChannelSender
    interface IChannel
    interface ISecurableChannel

Public Class TcpClientChannel
Implements IChannelSender, ISecurableChannel

Dědičnost

Object

TcpClientChannel

Implementuje

IChannel IChannelSender ISecurableChannel

Příklady

Následující příklad kódu ukazuje použití TcpClientChannel třídy k volání vzdáleného typu.

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

Vzdálený typ volaný ve výše uvedeném příkladu je definován následujícím kódem.

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

Poznámky

Důležité

Volání metod z této třídy s nedůvěryhodnými daty představuje bezpečnostní riziko. Metody z této třídy volejte pouze s důvěryhodnými daty. Další informace najdete v tématu Ověření všech vstupů.

Kanály přenášejí zprávy přes hranice vzdálené komunikace (například počítače nebo domény aplikace). Třída TcpClientChannel přenáší zprávy pomocí protokolu TCP.

Kanály se používají v infrastruktuře vzdálené komunikace rozhraní .NET Framework k přenosu vzdálených volání. Když klient provede volání vzdáleného objektu, volání je serializováno do zprávy, která je odeslána klientským kanálem a přijata kanálem serveru. Poté se deserializuje a zpracuje. Všechny vrácené hodnoty jsou přenášeny kanálem serveru a přijaty klientským kanálem.

Chcete-li provést další zpracování zpráv na straně klienta, můžete zadat implementaci IClientChannelSinkProvider rozhraní, přes které jsou předány všechny zprávy zpracované nástrojem TcpClientChannel .

Ve výchozím nastavení TcpClientChannel třída používá binární formátovací modul k serializaci všech zpráv.

Objekt TcpClientChannel má přidružené vlastnosti konfigurace, které lze nastavit za běhu buď v konfiguračním souboru (vyvoláním statické RemotingConfiguration.Configure metody), nebo programově (předáním IDictionary kolekce konstruktoru TcpClientChannel ). Seznam těchto vlastností konfigurace najdete v dokumentaci k TcpClientChannelnástroji .

Konstruktory

TcpClientChannel()	Inicializuje novou instanci TcpClientChannel třídy .
TcpClientChannel(IDictionary, IClientChannelSinkProvider)	Inicializuje novou instanci TcpClientChannel třídy se zadanými vlastnostmi konfigurace a jímkou.
TcpClientChannel(String, IClientChannelSinkProvider)	Inicializuje novou instanci TcpClientChannel třídy se zadaným názvem a jímkou.

Vlastnosti

ChannelName	Získá název aktuálního kanálu.
ChannelPriority	Získá prioritu aktuálního kanálu.
IsSecured	Získá nebo nastaví logickou hodnotu, která označuje, zda je aktuální kanál zabezpečený.

Metody

CreateMessageSink(String, Object, String)	Vrátí jímku zpráv kanálu, která doručuje zprávy na zadanou adresu URL nebo datový objekt kanálu.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
Parse(String, String)	Extrahuje identifikátor URI kanálu a identifikátor URI vzdáleného známého objektu ze zadané adresy URL.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)