Partager via


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

Définition

Retourne un récepteur de messages de canal qui remet les 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 délivrer les messages. Peut être null.

remoteChannelData
Object

Objet de données de canal de l'hôte distant auquel le nouveau récepteur doit délivrer les messages. Peut être null.

objectURI
String

Cette méthode retourne 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é sans être initialisé.

Retours

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

Implémente

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. url Les paramètres ou remoteChannelData peuvent être null, mais pas les deux.

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

S’applique à