IpcClientChannel.CreateMessageSink(String, Object, String) Methode

Definition

Gibt eine Channelnachrichtensenke zurück, die Meldungen an die angegebene URL oder das angegebene Channeldatenobjekt übermittelt.

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

Parameter

url
String

Die URL, an die die neue Senke Meldungen übermittelt. Dieser Parameter kann null sein.

remoteChannelData
Object

Das Channeldatenobjekt des Remotehosts, an den die neue Senke Meldungen übermittelt. Dieser Parameter kann null sein.

objectURI
String

Enthält beim Beenden dieser Methode den URI der neuen Channelnachrichtensenke, die Meldungen an die angegebene URL oder an das angegebene Channeldatenobjekt übermittelt. Dieser Parameter wird nicht initialisiert übergeben.

Gibt zurück

Eine Channelnachrichtensenke, die Meldungen an die angegebene URL oder das angegebene Channeldatenobjekt übermittelt.

Implementiert

Ausnahmen

Die bereitgestellte Senke implementiert IMessageSink nicht.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der CreateMessageSink-Methode veranschaulicht.

// 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());
}

Hinweise

Die CreateMessageSink -Methode gibt eine Kanalnachrichtensenke zurück, die Nachrichten entweder an die angegebene URL oder das Kanaldatenobjekt übermittelt. Wenn der uri Parameter ist null, remoteChannelData wird als Ziel für die Senke verwendet. Entweder die url Parameter oder remoteChannelData können sein null, aber nicht beide.

Gilt für: