IChannelSender.CreateMessageSink-Methode

Artikel
08/20/2007

Gibt einen Channelnachrichtenempfänger zurück, der Meldungen an den angegebenen URL oder das angegebene Channeldatenobjekt übermittelt.

Namespace: System.Runtime.Remoting.Channels
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
Function CreateMessageSink ( _
    url As String, _
    remoteChannelData As Object, _
    <OutAttribute> ByRef objectURI As String _
) As IMessageSink
'Usage
Dim instance As IChannelSender
Dim url As String
Dim remoteChannelData As Object
Dim objectURI As String
Dim returnValue As IMessageSink

returnValue = instance.CreateMessageSink(url, remoteChannelData, objectURI)

IMessageSink CreateMessageSink (
    string url,
    Object remoteChannelData,
    out string objectURI
)

IMessageSink^ CreateMessageSink (
    String^ url, 
    Object^ remoteChannelData, 
    [OutAttribute] String^% objectURI
)

IMessageSink CreateMessageSink (
    String url, 
    Object remoteChannelData, 
    /** @attribute OutAttribute() */ /** @ref */ String objectURI
)

JScript unterstützt die Übergabe von Werttypargumenten als Verweis nicht.

Parameter

url
Der URL, an den der neue Empfänger Meldungen übermittelt. Dieser kann NULL (Nothing in Visual Basic) sein.

remoteChannelData
Das Channeldatenobjekt des Remotehosts, an den der neue Empfänger Meldungen übermittelt. Dieses kann NULL (Nothing in Visual Basic) sein.

objectURI
Enthält bei der Rückgabe dieser Methode einen URI des neuen Channelnachrichtenempfängers, der Meldungen an den angegebenen URL oder an das angegebene Channeldatenobjekt übermittelt. Dieser Parameter wird nicht initialisiert übergeben.

Rückgabewert

Ein Channelnachrichtenempfänger, der Meldungen an den angegebenen URL oder an das angegebene Channeldatenobjekt übermittelt, oder NULL (Nothing in Visual Basic), wenn der Channel keine Verbindung mit dem angegebenen Endpunkt herstellen kann.

Ausnahmen

Ausnahmetyp	Bedingung
SecurityException	Der direkte Aufrufer verfügt nicht über die Berechtigung für die Infrastruktur.

Hinweise

Die CreateMessageSink-Methode gibt eine Channelmeldungssenke zurück, die Meldungen entweder an den angegebenen URL oder an das angegebene Channeldatenobjekt übermittelt. Wenn der uri-Parameter NULL (Nothing in Visual Basic) ist, wird der remoteChannelData-Parameter als Ziel für die Senke verwendet. Entweder der url-Parameter oder der remoteChannelData-Parameter, nicht jedoch beide Parameter können NULL (Nothing in Visual Basic) sein.

Beispiel

Imports System
Imports System.Collections
Imports System.Runtime.Remoting
Imports System.Runtime.Remoting.Channels
Imports System.Runtime.Remoting.Messaging
Imports System.Runtime.Remoting.Channels.Http
Imports System.Security.Permissions

Public Class MyClient
   <PermissionSet(SecurityAction.LinkDemand)> _
   Public Shared Sub Main()
      Try
         ' Create the 'IDictionary' to set the server object properties.
         Dim myDictionary As New Hashtable()
         myDictionary("name") = "HttpClientChannel"
         myDictionary("priority") = 2
         ' Set the properties along with the constructor.
         Dim myIChannelSender As New HttpClientChannel(myDictionary, _
                 New BinaryClientFormatterSinkProvider())
         ' Register the server channel.
         ChannelServices.RegisterChannel(myIChannelSender)
         Dim myHelloServer1 As MyHelloServer = CType(Activator.GetObject(GetType(MyHelloServer), _
                 "https://localhost:8085/SayHello"), MyHelloServer)
         If myHelloServer1 Is Nothing Then
            Console.WriteLine("Could not locate server")
         Else
            Console.WriteLine(myHelloServer1.myHelloMethod("Client"))
            ' Get the name of the channel.
            Console.WriteLine("Channel Name :" + myIChannelSender.ChannelName)
            ' Get the channel priority.
            Console.WriteLine("ChannelPriority :" + myIChannelSender.ChannelPriority.ToString())
            Dim myString As String = ""
            Dim myObjectURI1 As String = ""
            Console.WriteLine("Parse :" + myIChannelSender.Parse("https://localhost:8085/SayHello", _
                 myString) + myString)
            ' Get the channel message sink that delivers message to specified url.
            Dim myIMessageSink As IMessageSink = _
                 myIChannelSender.CreateMessageSink("https://localhost:8085/NewEndPoint", _
                 Nothing, myObjectURI1)
            Console.WriteLine("Channel message sink used :" + CType(myIMessageSink,Object).ToString())
            Console.WriteLine("URI of new channel message sink :" + myObjectURI1)
         End If
      Catch ex As Exception
         Console.WriteLine("Following exception is raised on client side : " + ex.Message)
      End Try
   End Sub 'Main
End Class 'MyClient

using System;
using System.Collections;
using System.Runtime.Remoting;
using System.Runtime.Remoting.Channels;
using System.Runtime.Remoting.Messaging;
using System.Runtime.Remoting.Channels.Http;
using System.Security.Permissions;

public class MyClient
{
   [PermissionSet(SecurityAction.LinkDemand)]
   public static void Main()
   {
      try
      {
         // Create the 'IDictionary' to set the server object properties.
         IDictionary myDictionary = new Hashtable();
         myDictionary["name"] = "HttpClientChannel";
         myDictionary["priority"] = 2;
         // Set the properties along with the constructor.
         IChannelSender myIChannelSender = new HttpClientChannel(myDictionary,
                                    new BinaryClientFormatterSinkProvider());
         // Register the server channel.
         ChannelServices.RegisterChannel(myIChannelSender);
         MyHelloServer myHelloServer1 = (MyHelloServer)Activator.GetObject(
                  typeof(MyHelloServer), "https://localhost:8085/SayHello");
         if (myHelloServer1 == null)
         {
            Console.WriteLine("Could not locate server");
         }
         else
         {
            Console.WriteLine(myHelloServer1.myHelloMethod("Client"));
            // Get the name of the channel.
            Console.WriteLine("Channel Name :" + myIChannelSender.ChannelName);
            // Get the channel priority.
            Console.WriteLine("ChannelPriority :" + 
                        myIChannelSender.ChannelPriority.ToString());
            string myString,myObjectURI1;
            Console.WriteLine("Parse :" + 
                myIChannelSender.Parse("https://localhost:8085/SayHello",out myString)
                + myString);
            // Get the channel message sink that delivers message to specified url.
            IMessageSink myIMessageSink = 
                  myIChannelSender.CreateMessageSink(
                  "https://localhost:8085/NewEndPoint", null,out myObjectURI1);
            Console.WriteLine("Channel message sink used :" + myIMessageSink.ToString());
            Console.WriteLine("URI of new channel message sink :" + myObjectURI1);
         }
      }
      catch(Exception ex)
      {
         Console.WriteLine("Following exception is raised on client side : " + ex.Message);
      }
   }
}

.NET Framework-Sicherheit

SecurityPermission für die Verwendung von Infrastrukturcode. Anforderungswert: SecurityAction.LinkDemand; Berechtigungswert: SecurityPermissionFlag.Infrastructure

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

IChannelSender-Schnittstelle
IChannelSender-Member
System.Runtime.Remoting.Channels-Namespace

Freigeben über