TcpClientChannel クラス

定義

名前空間:

System.Runtime.Remoting.Channels.Tcp

アセンブリ:

System.Runtime.Remoting.dll

リモート呼び出しの場合、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

継承

Object

TcpClientChannel

実装

IChannel IChannelSender ISecurableChannel

例

次のコード例は、 クラスを使用して TcpClientChannel リモート型を呼び出す方法を示しています。

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

上記の例で呼び出されたリモート型は、次のコードで定義されています。

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

注釈

重要

このクラスのメソッドを信頼されていないデータを指定して呼び出すことには、セキュリティ上のリスクが伴います。 このクラスのメソッドの呼び出しは、信頼されたデータだけを指定して実行してください。 詳細については、「 すべての入力を検証する」を参照してください。

チャネルは、リモート処理の境界を越えてメッセージを転送します (コンピューターやアプリケーション ドメインなど)。 クラスは TcpClientChannel 、TCP プロトコルを使用してメッセージを転送します。

チャネルは、リモート呼び出しを転送するために.NET Frameworkリモート処理インフラストラクチャによって使用されます。 クライアントがリモート オブジェクトを呼び出すと、その呼び出しは、クライアント チャネルによって送信され、サーバー チャネルによって受信されるメッセージにシリアル化されます。 その後、逆シリアル化され、処理されます。 返された値は、サーバー チャネルによって送信され、クライアント チャネルによって受信されます。

クライアント側でメッセージの追加処理を実行するには、 によって処理されるすべてのメッセージが IClientChannelSinkProvider 渡されるインターフェイスの実装を TcpClientChannel 指定できます。

既定では、 クラスは TcpClientChannel バイナリ フォーマッタを使用してすべてのメッセージをシリアル化します。

TcpClientChannelオブジェクトには、実行時に設定できる構成プロパティが関連付けられています。このプロパティは、構成ファイル (静的RemotingConfiguration.Configureメソッドを呼び出すことによって) またはプログラムによって (コンストラクターにTcpClientChannelコレクションを渡IDictionaryすことによって) 設定できます。 これらの構成プロパティの一覧については、 のドキュメントを参照してください TcpClientChannel。

コンストラクター

TcpClientChannel()	TcpClientChannel クラスの新しいインスタンスを初期化します。
TcpClientChannel(IDictionary, IClientChannelSinkProvider)	構成プロパティとシンクを指定して、TcpClientChannel クラスの新しいインスタンスを初期化します。
TcpClientChannel(String, IClientChannelSinkProvider)	名前とシンクを指定して、TcpClientChannel クラスの新しいインスタンスを初期化します。

プロパティ

ChannelName	現在のチャネルの名前を取得します。
ChannelPriority	現在のチャネルの優先順位を取得します。
IsSecured	現在のチャネルをセキュリティで保護しているかどうかを示すブール値を取得または設定します。

メソッド

CreateMessageSink(String, Object, String)	指定した URL またはチャネル データ オブジェクトにメッセージを配信するチャネル メッセージ シンクを返します。
Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
Parse(String, String)	指定した URL からチャネル URI と既知のリモート オブジェクト URI を抽出します。
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)