BinaryClientFormatterSinkProvider クラス

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

BinaryClientFormatterSinkProvider クラス

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

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

Visual Basic (宣言)

Public Class BinaryClientFormatterSinkProvider
    Implements IClientFormatterSinkProvider, IClientChannelSinkProvider

Visual Basic (使用法)

Dim instance As BinaryClientFormatterSinkProvider

C#

public class BinaryClientFormatterSinkProvider
 : IClientFormatterSinkProvider, IClientChannelSinkProvider

C++

public ref class BinaryClientFormatterSinkProvider
 : IClientFormatterSinkProvider, IClientChannelSinkProvider

J#

public class BinaryClientFormatterSinkProvider
 implements IClientFormatterSinkProvider, IClientChannelSinkProvider

JScript

public class BinaryClientFormatterSinkProvider
 implements IClientFormatterSinkProvider, IClientChannelSinkProvider

解説

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

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

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

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

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

継承階層

System.Object
  System.Runtime.Remoting.Channels.BinaryClientFormatterSinkProvider

スレッド セーフ

この型の 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

参照

関連項目
BinaryClientFormatterSinkProvider メンバ
System.Runtime.Remoting.Channels 名前空間
BinaryFormatter
その他の技術情報
チャネルおよびフォーマッタの構成プロパティ
リモート処理設定スキーマ