TcpServerChannel Klas

Definitie

public ref class TcpServerChannel : System::Runtime::Remoting::Channels::IChannelReceiver

public ref class TcpServerChannel : System::Runtime::Remoting::Channels::IChannelReceiver, System::Runtime::Remoting::Channels::ISecurableChannel

public class TcpServerChannel : System.Runtime.Remoting.Channels.IChannelReceiver

public class TcpServerChannel : System.Runtime.Remoting.Channels.IChannelReceiver, System.Runtime.Remoting.Channels.ISecurableChannel

type TcpServerChannel = class
    interface IChannelReceiver
    interface IChannel

type TcpServerChannel = class
    interface IChannelReceiver
    interface IChannel
    interface ISecurableChannel

Public Class TcpServerChannel
Implements IChannelReceiver

Public Class TcpServerChannel
Implements IChannelReceiver, ISecurableChannel

Overname

Object

TcpServerChannel

Implementeringen

IChannel IChannelReceiver ISecurableChannel

Voorbeelden

In het volgende codevoorbeeld ziet u het gebruik van een extern type.

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

In het volgende codevoorbeeld ziet u het gebruik van de TcpServerChannel klasse om een extern type beschikbaar te maken.

#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 server channel.
   TcpServerChannel^ serverChannel = gcnew TcpServerChannel( 9090 );
   ChannelServices::RegisterChannel( serverChannel );

   // Expose an object for remote calls.
   RemotingConfiguration::RegisterWellKnownServiceType( Remotable::typeid, "Remotable.rem", WellKnownObjectMode::Singleton );

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

   // Show the URIs associated with the channel.
   ChannelDataStore^ data = dynamic_cast<ChannelDataStore^>(serverChannel->ChannelData);
   System::Collections::IEnumerator^ myEnum = data->ChannelUris->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      String^ uri = safe_cast<String^>(myEnum->Current);
      Console::WriteLine( uri );
   }

   // Wait for method calls.
   Console::WriteLine( "Listening..." );
   Console::ReadLine();
}

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

public class Server
{
    public static void Main()
    {

        // Set up a server channel.
        TcpServerChannel serverChannel = new TcpServerChannel(9090);
        ChannelServices.RegisterChannel(serverChannel);

        // Expose an object for remote calls.
        RemotingConfiguration.RegisterWellKnownServiceType(
            typeof(Remotable), "Remotable.rem", WellKnownObjectMode.Singleton
        );

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

        // Show the URIs associated with the channel.
        ChannelDataStore data = (ChannelDataStore) serverChannel.ChannelData;
        foreach (string uri in data.ChannelUris)
        {
            Console.WriteLine(uri);
        }

        // Wait for method calls.
        Console.WriteLine("Listening...");
        Console.ReadLine();
    }
}

Opmerkingen

Kanalen transporteren berichten over externe grenzen (bijvoorbeeld computers of toepassingsdomeinen). De TcpServerChannel klasse transporteert berichten met behulp van het TCP-protocol.

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

Als u extra verwerking van berichten aan de serverzijde wilt uitvoeren, kunt u een implementatie van de IServerChannelSinkProvider interface opgeven waarmee alle berichten die door het TcpServerChannel exemplaar worden verwerkt, worden doorgegeven.

Het TcpServerChannel exemplaar accepteert berichten die in binaire of SOAP-indeling zijn geserialiseerd.

Een TcpServerChannel 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 TcpServerChannel constructor). Zie Eigenschappen voor kanaal- en opmaakconfiguratie voor een lijst met deze configuratie-eigenschappen.