TcpClientChannel Kelas

Definisi

Ruang nama:

System.Runtime.Remoting.Channels.Tcp

Rakitan:

System.Runtime.Remoting.dll

Untuk panggilan jarak jauh, terapkan saluran klien yang menggunakan protokol TCP untuk mengirimkan pesan.

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

Warisan

Object

TcpClientChannel

Penerapan

IChannel IChannelSender ISecurableChannel

Contoh

Contoh kode berikut menunjukkan penggunaan TcpClientChannel kelas untuk memanggil jenis jarak jauh.

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

Jenis jarak jauh yang disebut dalam contoh di atas ditentukan oleh kode berikut.

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

Keterangan

Penting

Metode panggilan dari kelas ini dengan data yang tidak tepercaya adalah risiko keamanan. Panggil metode dari kelas ini hanya dengan data tepercaya. Untuk informasi selengkapnya, lihat Memvalidasi Semua Input.

Saluran mengangkut pesan di seluruh batas jarak jauh (misalnya, komputer atau domain aplikasi). Kelas ini TcpClientChannel mengangkut pesan menggunakan protokol TCP.

Saluran digunakan oleh infrastruktur jarak jauh .NET Framework untuk mengangkut panggilan jarak jauh. Ketika klien melakukan panggilan ke objek jarak jauh, panggilan diserialisasikan ke dalam pesan yang dikirim oleh saluran klien dan diterima oleh saluran server. Kemudian dideserialisasi dan diproses. Setiap nilai yang dikembalikan ditransmisikan oleh saluran server dan diterima oleh saluran klien.

Untuk melakukan pemrosesan pesan tambahan di sisi klien, Anda dapat menentukan implementasi IClientChannelSinkProvider antarmuka tempat semua pesan yang diproses oleh TcpClientChannel diteruskan.

Secara default, TcpClientChannel kelas menggunakan pemformat biner untuk menserialisasikan semua pesan.

Objek TcpClientChannel memiliki properti konfigurasi terkait yang dapat diatur pada durasi baik dalam file konfigurasi (dengan memanggil metode statis RemotingConfiguration.Configure ) atau secara terprogram (dengan meneruskan IDictionary koleksi ke TcpClientChannel konstruktor). Untuk daftar properti konfigurasi ini, lihat dokumentasi untuk TcpClientChannel.

Konstruktor

TcpClientChannel()	Menginisialisasi instans baru kelas TcpClientChannel.
TcpClientChannel(IDictionary, IClientChannelSinkProvider)	Menginisialisasi instans TcpClientChannel baru kelas dengan properti konfigurasi dan sink yang ditentukan.
TcpClientChannel(String, IClientChannelSinkProvider)	Menginisialisasi instans TcpClientChannel baru kelas dengan nama dan sink yang ditentukan.

Properti

ChannelName	Mendapatkan nama saluran saat ini.
ChannelPriority	Mendapatkan prioritas saluran saat ini.
IsSecured	Mendapatkan atau menetapkan nilai Boolean yang menunjukkan apakah saluran saat ini aman.

Metode

CreateMessageSink(String, Object, String)	Mengembalikan sink pesan saluran yang mengirimkan pesan ke URL atau objek data saluran yang ditentukan.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
Parse(String, String)	Mengekstrak URI saluran dan URI objek terkenal jarak jauh dari URL yang ditentukan.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)