Sdílet prostřednictvím


TcpChannel.CreateMessageSink(String, Object, String) Metoda

Definice

Vrátí jímku zpráv kanálu, která doručuje zprávy do zadané adresy URL nebo datového objektu kanálu.

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

Parametry

url
String

Adresa URL, na kterou má nová jímka doručovat zprávy. Může být null.

remoteChannelData
Object

Datový objekt kanálu vzdáleného hostitele, na který má nová jímka doručovat zprávy. Může být null.

objectURI
String

Když tato metoda vrátí, obsahuje identifikátor URI nové jímky zpráv kanálu, která doručuje zprávy do zadané adresy URL nebo datového objektu kanálu. Tento parametr se předává neinicializovaný.

Návraty

Jímka zpráv kanálu, která doručuje zprávy do zadané adresy URL nebo datového objektu kanálu.

Implementuje

Příklady

Následující příklad kódu ukazuje, jak tuto metodu použít.

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

Poznámky

Metoda CreateMessageSink vrátí jímku zpráv kanálu, která doručuje zprávy buď do zadané adresy URL, nebo datového objektu kanálu. uri Pokud je nullparametr , remoteChannelData použije se jako cíl pro jímku. url Parametry nebo remoteChannelData mohou být null, ale ne oba.

Jímky kanálů poskytují bod modulu plug-in, který umožňuje přístup k podkladovým zprávám procházejících kanálem a také k datovému proudu používanému transportním mechanismem k odesílání zpráv do vzdáleného objektu. Jímky kanálů jsou propojeny v řetězu ChannelSinkProviders a všechny zprávy kanálu procházejí tímto řetězem jímek, než je zpráva konečně serializována a přenesena.

Platí pro