Freigeben über


RemotingServices.Disconnect-Methode

Verhindert, dass ein Objekt über die registrierten Remotechannels weitere Meldungen empfängt.

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

Syntax

'Declaration
Public Shared Function Disconnect ( _
    obj As MarshalByRefObject _
) As Boolean
'Usage
Dim obj As MarshalByRefObject
Dim returnValue As Boolean

returnValue = RemotingServices.Disconnect(obj)
public static bool Disconnect (
    MarshalByRefObject obj
)
public:
static bool Disconnect (
    MarshalByRefObject^ obj
)
public static boolean Disconnect (
    MarshalByRefObject obj
)
public static function Disconnect (
    obj : MarshalByRefObject
) : boolean

Parameter

  • obj
    Objekt, dessen Verbindung mit dem entsprechenden Channel getrennt werden soll.

Rückgabewert

true, wenn die Verbindung des Objekts mit den registrierten Remotechannels erfolgreich getrennt wurde, andernfalls false.

Ausnahmen

Ausnahmetyp Bedingung

ArgumentNullException

Der obj-Parameter ist NULL (Nothing in Visual Basic).

ArgumentException

Der obj-Parameter ist ein Proxy.

SecurityException

Der direkte Aufrufer hat keine Berechtigung zum Konfigurieren von Remotingtypen und Channels.

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie mit der Disconnect-Methode die Verbindung zwischen einem Objekt und den Remotechannels getrennt wird.

Dim channel As New TcpChannel(9000)
ChannelServices.RegisterChannel(channel)

Dim objectWellKnown As New SampleWellKnown()
' After the channel is registered, the object needs to be registered
' with the remoting infrastructure.  So, Marshal is called.
Dim objrefWellKnown As ObjRef = RemotingServices.Marshal(objectWellKnown, "objectWellKnownUri")
Console.WriteLine("An instance of SampleWellKnown type is published at {0}.", objrefWellKnown.URI)

Console.WriteLine("Press enter to unregister SampleWellKnown, so that it is no longer available on this channel.")
Console.ReadLine()
RemotingServices.Disconnect(objectWellKnown)
Console.WriteLine("Press enter to end the server process.")
Console.ReadLine()
TcpChannel channel = new TcpChannel(9000);
ChannelServices.RegisterChannel(channel);

SampleWellKnown objectWellKnown = new SampleWellKnown();

// After the channel is registered, the object needs to be registered
// with the remoting infrastructure.  So, Marshal is called.
ObjRef objrefWellKnown = RemotingServices.Marshal(objectWellKnown, "objectWellKnownUri");
Console.WriteLine("An instance of SampleWellKnown type is published at {0}.", objrefWellKnown.URI);

Console.WriteLine("Press enter to unregister SampleWellKnown, so that it is no longer available on this channel.");
Console.ReadLine();
RemotingServices.Disconnect(objectWellKnown);

Console.WriteLine("Press enter to end the server process.");
Console.ReadLine();
TcpChannel^ channel = gcnew TcpChannel( 9000 );
ChannelServices::RegisterChannel( channel );
SampleWellKnown ^ objectWellKnown = gcnew SampleWellKnown;

// After the channel is registered, the Object* needs to be registered
// with the remoting infrastructure.  So, Marshal is called.
ObjRef^ objrefWellKnown = RemotingServices::Marshal( objectWellKnown, "objectWellKnownUri" );
Console::WriteLine( "An instance of SampleWellKnown type is published at {0}.", objrefWellKnown->URI );
Console::WriteLine( "Press enter to unregister SampleWellKnown, so that it is no longer available on this channel." );
Console::ReadLine();
RemotingServices::Disconnect( objectWellKnown );
Console::WriteLine( "Press enter to end the server process." );
Console::ReadLine();

.NET Framework-Sicherheit

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

RemotingServices-Klasse
RemotingServices-Member
System.Runtime.Remoting-Namespace