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

Référence

Définition

Espace de noms:: System.Runtime.Remoting.Channels.Ipc

Assembly:: System.Runtime.Remoting.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

IMessageSink

Récepteur de messages de canal qui remet les 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 la méthode CreateMessageSink. Cet exemple de code fait partie d’un exemple plus grand fourni pour la IpcChannel classe .

// Create a message sink.
String^ objectUri;
System::Runtime::Remoting::Messaging::IMessageSink^ messageSink = channel->CreateMessageSink(
   L"ipc://localhost:9090/RemoteObject.rem", nullptr, objectUri );
Console::WriteLine( L"The URI of the message sink is {0}.", objectUri );
if ( messageSink != nullptr )
{
   Console::WriteLine( L"The type of the message sink is {0}.", messageSink->GetType() );
}

// Create a message sink.
string objectUri;
System.Runtime.Remoting.Messaging.IMessageSink messageSink =
    channel.CreateMessageSink(
        "ipc://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 transitant 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 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 à

Partager via