TcpClientChannel.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.Tcp
Assembly: System.Runtime.Remoting (in system.runtime.remoting.dll)

Syntax

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

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

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

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

public 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 die neue Senke 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

Eine Channelnachrichtensenke, die Meldungen an den angegebenen URL oder das angegebene Channeldatenobjekt übermittelt.

Hinweise

Die CreateMessageSink-Methode gibt eine Channelnachrichtensenke 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 remoteChannelData als Ziel für die Senke verwendet. Nur der url-Parameter oder nur der remoteChannelData-Parameter kann NULL (Nothing in Visual Basic) sein, jedoch nicht beide.

Beispiel

Im folgenden Codebeispiel wird die Verwendung dieser Methode veranschaulicht.

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

// 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 );
Console::WriteLine( "The type of the message sink is {0}.", messageSink->GetType() );

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter .

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

TcpClientChannel-Klasse
TcpClientChannel-Member
System.Runtime.Remoting.Channels.Tcp-Namespace

Freigeben über