TcpChannel.CreateMessageSink(String, Object, String) Méthode

Définition

Espace de noms:
System.Runtime.Remoting.Channels.Tcp
Assembly:
System.Runtime.Remoting.dll

Retourne un récepteur de messages de canal qui remet des messages à l’URL ou à l’objet de données de canal spécifié.

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

Paramètres

url
String

URL à laquelle le nouveau récepteur doit remettre des messages. Peut être null.

remoteChannelData
Object

Objet de données de canal de l’hôte distant auquel le nouveau récepteur doit remettre des messages. Peut être null.

objectURI
String

Lorsque cette méthode est retournée, contient un URI du nouveau récepteur de messages de canal qui remet des messages à l’URL ou à l’objet de données de canal spécifié. Ce paramètre est passé non initialisé.

Retours

IMessageSink

Récepteur de messages de canal qui remet des messages à l’URL ou à l’objet de données de canal spécifié.

Implémente

CreateMessageSink(String, Object, String)

Exemples

L’exemple de code suivant montre comment utiliser cette méthode.

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

Remarques

La CreateMessageSink méthode retourne un récepteur de messages de canal qui remet des messages à l’URL ou à l’objet de données de canal spécifié. Si le uri paramètre est null, remoteChannelData est utilisé comme cible pour le récepteur. Les paramètres remoteChannelData ou les url deux peuvent êtrenull, mais pas les deux.

Les récepteurs de canal fournissent un point de plug-in qui permet d’accéder aux messages sous-jacents qui transitent par le canal, ainsi que le flux utilisé par le mécanisme de transport pour envoyer des messages à un objet distant. Les récepteurs de canal sont liés dans une chaîne de messages de ChannelSinkProviders canal et tous les messages de canal transitent par cette chaîne de récepteurs avant que le message soit finalement sérialisé et transporté.

S’applique à