TcpClientChannel Klasse

Definition

Namespace:

System.Runtime.Remoting.Channels.Tcp

Assembly:

System.Runtime.Remoting.dll

Implementiert für Remoteaufrufe einen Clientchannel, der Meldungen mithilfe von TCP überträgt.

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

Vererbung

Object

TcpClientChannel

Implementiert

IChannel IChannelSender ISecurableChannel

Beispiele

Das folgende Codebeispiel zeigt die Verwendung der TcpClientChannel -Klasse zum Aufrufen eines Remotetyps.

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

Der im obigen Beispiel aufgerufene Remotetyp wird durch den folgenden Code definiert.

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

Hinweise

Wichtig

Das Aufrufen von Methoden aus dieser Klasse mit nicht vertrauenswürdigen Daten stellt ein Sicherheitsrisiko dar. Rufen Sie die Methoden aus dieser Klasse nur mit vertrauenswürdigen Daten auf. Weitere Informationen finden Sie unter Überprüfen aller Eingaben.

Kanäle transportieren Nachrichten über Remotinggrenzen hinweg (z. B. Computer oder Anwendungsdomänen). Die TcpClientChannel -Klasse transportiert Nachrichten mithilfe des TCP-Protokolls.

Kanäle werden von der .NET Framework Remotinginfrastruktur verwendet, um Remoteanrufe zu transportieren. Wenn ein Client ein Remoteobjekt aufruft, wird der Aufruf in eine Nachricht serialisiert, die von einem Clientkanal gesendet und von einem Serverkanal empfangen wird. Es wird dann deserialisiert und verarbeitet. Alle zurückgegebenen Werte werden vom Serverkanal übertragen und vom Clientkanal empfangen.

Zum Ausführen einer zusätzlichen Verarbeitung von Nachrichten auf der Clientseite können Sie eine Implementierung der Schnittstelle angeben, über die IClientChannelSinkProvider alle von der TcpClientChannel verarbeiteten Nachrichten übergeben werden.

Standardmäßig verwendet die TcpClientChannel Klasse einen Binärformatierer, um alle Nachrichten zu serialisieren.

Ein TcpClientChannel Objekt verfügt über zugeordnete Konfigurationseigenschaften, die zur Laufzeit entweder in einer Konfigurationsdatei (durch Aufrufen der statischen RemotingConfiguration.Configure Methode) oder programmgesteuert (durch Übergeben einer IDictionary Auflistung an den TcpClientChannel Konstruktor) festgelegt werden können. Eine Liste dieser Konfigurationseigenschaften finden Sie in der Dokumentation zu TcpClientChannel.

Konstruktoren

TcpClientChannel()	Initialisiert eine neue Instanz der TcpClientChannel-Klasse.
TcpClientChannel(IDictionary, IClientChannelSinkProvider)	Initialisiert eine neue Instanz der TcpClientChannel-Klasse mit den angegebenen Konfigurationseigenschaften und Konfigurationssenken.
TcpClientChannel(String, IClientChannelSinkProvider)	Initialisiert eine neue Instanz der TcpClientChannel-Klasse mit dem angegebenen Namen und der angegebenen Senke.

Eigenschaften

ChannelName	Ruft den Namen des aktuellen Channels ab.
ChannelPriority	Ruft die Priorität des aktuellen Channels ab.
IsSecured	Ruft einen booleschen Wert ab, der angibt, ob der aktuelle Channel sicher ist, oder legt diesen fest.

Methoden

CreateMessageSink(String, Object, String)	Gibt eine Channelnachrichtensenke zurück, die Meldungen an die angegebene URL oder das angegebene Channeldatenobjekt übermittelt.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
Parse(String, String)	Extrahiert aus der angegebenen URL den Channel-URI und den URI des bekannten Remoteobjekts.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)