TcpChannel.CreateMessageSink(String, Object, String) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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 null
parametr , 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.