TcpChannel.CreateMessageSink(String, Object, String) Méthode
Définition
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
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é.