RemotingServices.Disconnect(MarshalByRefObject) Methode

Definition

Namespace:

System.Runtime.Remoting

Assembly:

mscorlib.dll

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

public:
 static bool Disconnect(MarshalByRefObject ^ obj);

[System.Security.SecurityCritical]
public static bool Disconnect (MarshalByRefObject obj);

[<System.Security.SecurityCritical>]
static member Disconnect : MarshalByRefObject -> bool

Public Shared Function Disconnect (obj As MarshalByRefObject) As Boolean

Parameter

obj

MarshalByRefObject

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

Gibt zurück

Boolean

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

Attribute

SecurityCriticalAttribute

Ausnahmen

ArgumentNullException

Der obj-Parameter ist null.

ArgumentException

Der obj-Parameter ist ein Proxy.

SecurityException

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

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie die Disconnect -Methode verwenden, um ein Objekt von den Remotingkanälen zu trennen.

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

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

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()