HttpChannel クラス

メッセージを送信するために HTTP プロトコルを使用する送信者と受信者間のチャネルの実装を提供します。

この型のすべてのメンバの一覧については、HttpChannel メンバ を参照してください。

System.Object
   System.Runtime.Remoting.Channels.BaseChannelObjectWithProperties
      System.Runtime.Remoting.Channels.BaseChannelWithProperties
         System.Runtime.Remoting.Channels.Http.HttpChannel

Public Class HttpChannel
   Inherits BaseChannelWithProperties
   Implements IChannelReceiver, IChannel, IChannelSender, _
   IChannelReceiverHook
[C#]
public class HttpChannel : BaseChannelWithProperties,
   IChannelReceiver, IChannel, IChannelSender, IChannelReceiverHook
[C++]
public __gc class HttpChannel : public BaseChannelWithProperties,
   IChannelReceiver, IChannel, IChannelSender, IChannelReceiverHook
[JScript]
public class HttpChannel extends BaseChannelWithProperties
   implements IChannelReceiver, IChannel, IChannelSender,
   IChannelReceiverHook

スレッドセーフ

この型の public static (Visual Basicでは Shared) のすべてのメンバは、マルチスレッド操作で安全に使用できます。インスタンスのメンバの場合は、スレッドセーフであるとは限りません。

解説

HttpChannel クラスは結合されたチャネルです。これは便宜のために HttpServerChannel と HttpClientChannel を結合します。 HttpChannel は、SOAP プロトコルを使用して、リモート オブジェクトとの間でメッセージを転送します。すべての発信メッセージは、SOAP フォーマッタを経由して渡されます。そのフォーマッタでメッセージは XML に変換された後にシリアル化され、要求する SOAP ヘッダーがストリームに追加されます。バイナリ フォーマッタを指定することもできます。この場合は、バイナリ データ ストリームが生成されます。その後、データ ストリームは HTTP プロトコルを使用して、対象の URI に転送されます。着信メッセージでは、処理が逆になります。

チャネルは、アプリケーション ドメイン、プロセス、コンピュータなどのリモート処理境界を超えて、アプリケーション間でメッセージを転送します。このような転送には、着信と発信の両方があります。現在のチャネルは、エンド ポイントで着信メッセージを待機し、発信メッセージをそのエンド ポイントに送信します。 HttpChannel は、通過するメッセージを XML 形式との間で変換し、HTTP プロトコルを使用してメッセージを送受信します。

クライアント側では、メッセージはクライアント Context チェインを走査した後に、クライアント チャネル シンク チェインに渡されます。通常、最初のチャネル シンクは、メッセージをストリームにシリアル化する IClientFormatterSink です。このストリームは、チャネル シンク チェインからクライアント トランスポート シンクに渡されます。その後、クライアント トランスポート シンクは、このストリームをワイヤに書き込みます。

サーバー側では、サーバー トランスポート シンクは、ワイヤから要求を読み取り、要求ストリームをサーバー チャネル シンク チェインに渡します。このチェインの終端にあるサーバー フォーマッタ シンクは、要求をメッセージに逆シリアル化します。その後、このメッセージをリモート処理インフラストラクチャに渡し、このインフラストラクチャがサーバー Context チェインにディスパッチします。

IChannel 実装は、チャネル構成プロパティを使用して、実行時にチャネルを構成します。チャネル プロパティは、構成ファイルで指定したり、 IDictionary 内でプログラムによって指定したりできます。構成ファイルではすべての値が文字列によって表されますが、 IDictionary プロパティをプログラムによって構築する場合は、値型をネイティブな値または文字列で指定できます。

現在のチャネルに対して指定できるチャネル構成プロパティを次の表に示します。

使用例

[Visual Basic, C#, C++] HttpChannel を登録して、ポート 9000 で要求を待機する簡単なホスト アプリケーションについては、次のコード例を参照してください。

 
Dim channelProperties As New ListDictionary()
channelProperties.Add("port", 9000)

Dim channel As New HttpChannel(channelProperties, New SoapClientFormatterSinkProvider(), New SoapServerFormatterSinkProvider())
ChannelServices.RegisterChannel(channel)
RemotingConfiguration.RegisterWellKnownServiceType(GetType(SampleService), "MySampleService/SampleService.soap", WellKnownObjectMode.Singleton)

Console.WriteLine("** Press enter to end the server process. **")
Console.ReadLine()

[C#] 
ListDictionary channelProperties = new ListDictionary();

channelProperties.Add("port", 9000);

HttpChannel channel = new HttpChannel(channelProperties,
                                      new SoapClientFormatterSinkProvider(),
                                      new SoapServerFormatterSinkProvider());

ChannelServices.RegisterChannel(channel);

RemotingConfiguration.RegisterWellKnownServiceType(typeof(SampleService), 
                    "MySampleService/SampleService.soap",
                    WellKnownObjectMode.Singleton);

Console.WriteLine("** Press enter to end the server process. **");
Console.ReadLine();

[C++] 
ListDictionary* channelProperties = new ListDictionary();

channelProperties->Add(S"port", __box(9000));

HttpChannel* channel = new HttpChannel(channelProperties,
    new SoapClientFormatterSinkProvider(),
    new SoapServerFormatterSinkProvider());

ChannelServices::RegisterChannel(channel);

RemotingConfiguration::RegisterWellKnownServiceType(__typeof(SampleService), 
    S"MySampleService/SampleService::soap",
    WellKnownObjectMode::Singleton);

Console::WriteLine(S"** Press enter to end the server process. **");
Console::ReadLine();

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

名前空間: System.Runtime.Remoting.Channels.Http

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

アセンブリ: System.Runtime.Remoting (System.Runtime.Remoting.dll 内)

参照

HttpChannel メンバ | System.Runtime.Remoting.Channels.Http 名前空間 | SoapFormatter | BinaryFormatter | チャネルおよびフォーマッタの構成プロパティ