HttpChannel.CreateMessageSink-Methode

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

Namespace: System.Runtime.Remoting.Channels.Http
Assembly: System.Runtime.Remoting (in system.runtime.remoting.dll)

Syntax

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

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

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

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

public final 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 die neue Senke 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 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 der CreateMessageSink-Methode veranschaulicht. Dieses Codebeispiel ist Teil eines umfangreicheren Beispiels für die HttpClientChannel-Klasse.

// Create a message sink.
string objectUri;
System.Runtime.Remoting.Messaging.IMessageSink messageSink = 
    clientChannel.CreateMessageSink(
    "https://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( L"https://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() );
}

.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

HttpChannel-Klasse
HttpChannel-Member
System.Runtime.Remoting.Channels.Http-Namespace