TcpChannel.CreateMessageSink(String, Object, String) Methode

Definition

Namespace:
System.Runtime.Remoting.Channels.Tcp
Assembly:
System.Runtime.Remoting.dll

Gibt eine Kanalnachrichtensenke zurück, die Nachrichten an das angegebene URL- oder Kanaldatenobjekt übermittelt.

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

Parameter

url
String

Die URL, an die die neue Spüle Nachrichten übermitteln soll. Kann null sein.

remoteChannelData
Object

Das Kanaldatenobjekt des Remotehosts, an den die neue Spüle Nachrichten übermitteln soll. Kann null sein.

objectURI
String

Wenn diese Methode zurückgegeben wird, enthält sie einen URI der neuen Kanalnachrichtensenke, die Nachrichten an das angegebene URL- oder Kanaldatenobjekt übermittelt. Dieser Parameter wird nicht initialisiert übergeben.

Gibt zurück

IMessageSink

Eine Kanalnachrichtensenke, die Nachrichten an das angegebene URL- oder Kanaldatenobjekt übermittelt.

Implementiert

CreateMessageSink(String, Object, String)

Beispiele

Das folgende Codebeispiel zeigt, wie diese Methode verwendet wird.

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

Hinweise

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

Kanalsenken bieten einen Plug-In-Punkt, der den Zugriff auf die zugrunde liegenden Nachrichten ermöglicht, die über den Kanal fließen, sowie den Datenstrom, der vom Transportmechanismus zum Senden von Nachrichten an ein Remoteobjekt verwendet wird. Kanalsenken sind in einer Kette miteinander ChannelSinkProviders verknüpft, und alle Kanalnachrichten fließen durch diese Kette von Senken, bevor die Nachricht schließlich serialisiert und transportiert wird.

Gilt für: