TcpChannel.CreateMessageSink(String, Object, String) 方法

定義

命名空間:

System.Runtime.Remoting.Channels.Tcp

組件:

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

遠端主機的通道資料物件，新接收 (Sink) 應該傳遞訊息給該遠端主機。 可以是 null。

objectURI

String

當這個方法傳回時，包含新通道訊息接收的 URI，此 URI 傳遞訊息給指定 URL 或通道資料物件。 這個參數會以未初始化的狀態傳遞。

傳回

IMessageSink

通道訊息接收，會傳遞訊息給指定的 URL 或通道資料物件。

實作

CreateMessageSink(String, Object, String)

範例

下列程式碼範例會顯示如何使用這個方法。

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

// Create a message sink.
string objectUri;
System.Runtime.Remoting.Messaging.IMessageSink messageSink =
    clientChannel.CreateMessageSink(
        "tcp://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如果 參數為 null ， remoteChannelData 則會作為接收的目標。 url或 remoteChannelData 參數可以是 null ，但不能是兩者。

通道接收提供外掛程式點，允許存取流經通道的基礎訊息，以及傳輸機制用來將訊息傳送至遠端物件的資料流程。 通道接收會連結在 的 ChannelSinkProviders 鏈結中，而且所有通道訊息都會流經這個接收鏈結，然後訊息最後序列化和傳輸。