IpcClientChannel.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 virtual 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 Overridable Function CreateMessageSink (url As String, remoteChannelData As Object, ByRef objectURI As String) As IMessageSink

參數

url

String

新接收傳遞訊息的目標 URL。 這個參數可以是 null。

remoteChannelData

Object

遠端主機的通道資料物件，新接收應該將訊息傳遞至遠端主機。 這個參數可以是 null。

objectURI

String

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

傳回

IMessageSink

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

實作

CreateMessageSink(String, Object, String)

例外狀況

RemotingException

所提供的接收不實作 IMessageSink。

範例

下列程式碼範例示範如何使用 CreateMessageSink 方法。

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

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

備註

方法 CreateMessageSink 會傳回信道訊息接收，將訊息傳遞至指定的 URL 或通道資料物件。 uri如果 參數為 null ， remoteChannelData 則會作為接收的目標。 url或 remoteChannelData 參數可以是 null ，但不能是兩者。