IpcChannel.CreateMessageSink(String, Object, String) メソッド

定義

名前空間:

System.Runtime.Remoting.Channels.Ipc

アセンブリ:

System.Runtime.Remoting.dll

指定した URL またはチャネル データ オブジェクトにメッセージを配信するチャネル メッセージ シンクを返します。

public:
 virtual System::Runtime::Remoting::Messaging::IMessageSink ^ CreateMessageSink(System::String ^ url, System::Object ^ remoteChannelData, [Runtime::InteropServices::Out] System::String ^ % objectURI);

public System.Runtime.Remoting.Messaging.IMessageSink CreateMessageSink (string url, object remoteChannelData, out string objectURI);

abstract member CreateMessageSink : string * obj * string -> System.Runtime.Remoting.Messaging.IMessageSink
override this.CreateMessageSink : string * obj * string -> System.Runtime.Remoting.Messaging.IMessageSink

Public Function CreateMessageSink (url As String, remoteChannelData As Object, ByRef objectURI As String) As IMessageSink

パラメーター

url

String

新しいシンクがメッセージを配信する先の URL。 null の可能性があります。

remoteChannelData

Object

新しいシンクがメッセージを配信する先のリモート ホストのチャネル データ オブジェクト。 null の可能性があります。

objectURI

String

このメソッドが返されるときに、指定した URL またはチャネル データ オブジェクトにメッセージを配信する新しいチャネル メッセージ シンクの URI を格納します。 このパラメーターは初期化せずに渡されます。

戻り値

IMessageSink

指定した URL またはチャネル データ オブジェクトにメッセージを配信するチャネル メッセージ シンク。

実装

CreateMessageSink(String, Object, String)

例

CreateMessageSink メソッドを使用するコード例を次に示します。 このコード例は、IpcChannel クラスのために提供されている大規模な例の一部です。

// Create a message sink.
String^ objectUri;
System::Runtime::Remoting::Messaging::IMessageSink^ messageSink = channel->CreateMessageSink(
   L"ipc://localhost:9090/RemoteObject.rem", nullptr, objectUri );
Console::WriteLine( L"The URI of the message sink is {0}.", objectUri );
if ( messageSink != nullptr )
{
   Console::WriteLine( L"The type of the message sink is {0}.", messageSink->GetType() );
}

// Create a message sink.
string objectUri;
System.Runtime.Remoting.Messaging.IMessageSink messageSink =
    channel.CreateMessageSink(
        "ipc://localhost:9090/RemoteObject.rem", null,
        out objectUri);
Console.WriteLine("The URI of the message sink is {0}.",
    objectUri);
if (messageSink != null)
{
    Console.WriteLine("The type of the message sink is {0}.",
        messageSink.GetType().ToString());
}

注釈

メソッドは CreateMessageSink 、指定された URL またはチャネル データ オブジェクトにメッセージを配信するチャネル メッセージ シンクを返します。 パラメーターが のuri場合は remoteChannelDatanull、 がシンクのターゲットとして使用されます。 または remoteChannelData パラメーターを url にすることはできますが、両方を指定nullすることはできません。

チャネル シンクは、チャネルを通過する基になるメッセージと、リモート オブジェクトにメッセージを送信するためにトランスポート メカニズムで使用されるストリームへのアクセスを許可するプラグイン ポイントを提供します。 チャネル シンクは の ChannelSinkProviders チェーンでリンクされ、メッセージが最終的にシリアル化されて転送される前に、すべてのチャネル メッセージがこのシンク チェーンを通過します。