SoapClientFormatterSinkProvider クラス

.NET Framework クラス ライブラリ リファレンス

SoapClientFormatterSinkProvider クラス

クライアント フォーマッタ シンク プロバイダの実装を提供します。

名前空間: System.Runtime.Remoting.Channels
アセンブリ: System.Runtime.Remoting (system.runtime.remoting.dll 内)
構文

Visual Basic (宣言)

Public Class SoapClientFormatterSinkProvider
    Implements IClientFormatterSinkProvider, IClientChannelSinkProvider

Visual Basic (使用法)

Dim instance As SoapClientFormatterSinkProvider

C#

public class SoapClientFormatterSinkProvider
 : IClientFormatterSinkProvider, IClientChannelSinkProvider

C++

public ref class SoapClientFormatterSinkProvider
 : IClientFormatterSinkProvider, IClientChannelSinkProvider

J#

public class SoapClientFormatterSinkProvider
 implements IClientFormatterSinkProvider, IClientChannelSinkProvider

JScript

public class SoapClientFormatterSinkProvider
 implements IClientFormatterSinkProvider, IClientChannelSinkProvider

解説

SoapClientFormatterSinkProvider は、SoapFormatter を使用するクライアント フォーマッタ シンクを作成して、リモート処理メッセージが流れるクライアント チャネル用にメッセージをシリアル化します。

フォーマッタ シンクの関数では、必要なヘッダーを生成し、ストリームにメッセージをシリアル化します。フォーマッタ シンクに到達すると、ProcessMessage 呼び出しまたは AsyncProcessRequest 呼び出しを通じて、IMessage がチャネル シンク チェインのすべてのシンクに転送されます。この段階では、メッセージが既にシリアル化されており、情報としてだけ提供されます。メッセージを作成または変更する必要があるシンクは、フォーマッタの前に、シンク チェイン内に配置する必要があります。これを実行するには、IMessageSink インターフェイスと IClientChannelSink インターフェイスの両方を実装します。フォーマッタ シンクは、後でシンク チェイン内に配置できます。

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

現在のシンク プロバイダに対して指定できるシンク構成プロパティを次の表に示します。

プロパティ	説明
includeVersions	フォーマッタにバージョン情報が含まれるかどうかを指定します。値は true または false です。

継承階層

System.Object
  System.Runtime.Remoting.Channels.SoapClientFormatterSinkProvider

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
SoapClientFormatterSinkProvider メンバ
System.Runtime.Remoting.Channels 名前空間
BinaryFormatter
その他の技術情報
チャネルおよびフォーマッタの構成プロパティ
シンクとシンク チェーン