System.Runtime.Remoting Namespace
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt Klassen und Schnittstellen bereit, mit denen Entwickler verteilte Anwendungen erstellen und konfigurieren können. Einige der wichtigeren Klassen des System.Runtime.Remoting Namespaces sind die RemotingConfiguration Klasse, die RemotingServices Klasse und die ObjRef Klasse.
Klassen
| Name | Beschreibung |
|---|---|
| ActivatedClientTypeEntry |
Enthält Werte für einen Objekttyp, der auf dem Clientende als Typ registriert ist, der auf dem Server aktiviert werden kann. |
| ActivatedServiceTypeEntry |
Enthält Werte für einen Objekttyp, der am Dienstende registriert ist, als einen, der auf Anforderung von einem Client aktiviert werden kann. |
| InternalRemotingServices |
Definiert Hilfsmethoden für die Verwendung durch die .NET Framework-Remotinginfrastruktur. |
| ObjectHandle |
Umschließt Marshal-by-Value-Objektverweise, sodass sie über eine Dereferenzierung zurückgegeben werden können. |
| ObjRef |
Speichert alle relevanten Informationen, die zum Generieren eines Proxys erforderlich sind, um mit einem Remoteobjekt zu kommunizieren. |
| RemotingConfiguration |
Stellt verschiedene statische Methoden zum Konfigurieren der Remotinginfrastruktur bereit. |
| RemotingException |
Die Ausnahme, die ausgelöst wird, wenn beim Remoting ein Fehler aufgetreten ist. |
| RemotingServices |
Stellt mehrere Methoden zum Verwenden und Veröffentlichen von Remoteobjekten und Proxys bereit. Diese Klasse kann nicht vererbt werden. |
| RemotingTimeoutException |
Die Ausnahme, die ausgelöst wird, wenn der Server oder der Client für einen zuvor angegebenen Zeitraum nicht erreicht werden kann. |
| ServerException |
Die Ausnahme, die ausgelöst wird, um Fehler an den Client zu übermitteln, wenn der Client eine Verbindung mit Nicht-.NET Framework-Anwendungen herstellt, die keine Ausnahmen auslösen können. |
| SoapServices |
Stellt mehrere Methoden zum Verwenden und Veröffentlichen von Remoteobjekten im SOAP-Format bereit. |
| TypeEntry |
Implementiert eine Basisklasse, die die Konfigurationsinformationen enthält, die zum Aktivieren einer Instanz eines Remotetyps verwendet werden. |
| WellKnownClientTypeEntry |
Enthält Werte für einen Objekttyp, der auf dem Client als serveraktiver Typ registriert ist (einzelner Aufruf oder Singleton). |
| WellKnownServiceTypeEntry |
Enthält Werte für einen Objekttyp, der am Dienstende als serveraktives Typobjekt registriert ist (einzelner Aufruf oder Singleton). |
Schnittstellen
| Name | Beschreibung |
|---|---|
| IChannelInfo |
Stellt benutzerdefinierte Kanalinformationen bereit, die zusammen mit der ObjRef. |
| IEnvoyInfo |
Stellt Informationen zur Verfügung. |
| IObjectHandle |
Definiert die Schnittstelle zum Entpacken von Marshal-by-Value-Objekten aus der Dereferenzierung. |
| IRemotingTypeInfo |
Stellt Typinformationen für ein Objekt bereit. |
Enumerationen
| Name | Beschreibung |
|---|---|
| CustomErrorsModes |
Gibt an, wie benutzerdefinierte Fehler behandelt werden. |
| WellKnownObjectMode |
Definiert, wie bekannte Objekte aktiviert werden. |
Hinweise
Die RemotingConfiguration Klasse enthält statische Methoden für die Interfacing mit Konfigurationseinstellungen. Mit RemotingConfiguration.Configure der Methode können Entwickler die Remotinginfrastruktur mithilfe von XML-formatierten Konfigurationsdateien konfigurieren. Die RemotingConfiguration Klasse enthält auch mehrere Methoden für die Client-End- und Server-End-Registrierung von client- und serveraktivierten Objekten, die sich auf dem Server befinden.
Die RemotingServices Klasse stellt eine Reihe von Methoden bereit, mit denen Remoteobjekte verwendet und veröffentlicht werden können. Die RemotingServices.Marshal Methode stellt die Funktionalität zum Speichern aller relevanten Informationen bereit, die zum Aktivieren und Kommunizieren mit einem Remoteobjekt in einer Instanz der ObjRef Klasse zur späteren Serialisierung und Übertragung an einen Remotestandort erforderlich sind. Die RemotingServices.Unmarshal Methode kehrt diesen Prozess um und erstellt einen Proxy für ein Remoteobjekt, das von einer Anwendung ohne Rücksicht auf Remotingunterteilungen verwendet werden kann.
Die ObjRef Klasse enthält alle relevanten Informationen, die zum Aktivieren und Kommunizieren mit einem Remoteobjekt erforderlich sind. Diese Klasse ist eine serialisierbare Darstellung eines Objekts, das mithilfe eines Kanals an einen Remotestandort übertragen wird, in dem es unvermarstet ist (siehe Unmarshal) und kann verwendet werden, um einen lokalen Proxy des remoted-Objekts zu erstellen.
Hinweis
Marshal-by-Reference-Objekte (MBRs) befinden sich nicht für immer im Arbeitsspeicher. Wenn der Typ nicht MarshalByRefObject.InitializeLifetimeService außer Kraft setzt, um seine eigenen Lebensdauerrichtlinien zu steuern, verfügt jedes MBR über eine endliche Lebensdauer, bevor das .NET Framework-Remoting-System mit dem Löschen beginnt und den Speicher zurückgibt.
