System.Runtime.Remoting Namespace

Stellt Klassen und Schnittstellen bereit, die Entwicklern das Erstellen und Konfigurieren verteilter Anwendungen ermöglichen. Einige der wichtigeren Klassen des System.Runtime.Remoting-Namespaces sind die RemotingConfiguration-Klasse, die RemotingServices-Klasse und die ObjRef-Klasse.

Klassen

ActivatedClientTypeEntry

Enthält Werte für einen Objekttyp, der auf der Clientseite als Typ registriert ist, der auf dem Server aktiviert werden kann.

ActivatedServiceTypeEntry

Enthält Werte für einen Objekttyp, der auf der Dienstseite als solcher registriert ist und auf Anforderung eines Clients aktiviert werden kann.

InternalRemotingServices

Definiert Dienstmethoden für die Verwendung durch die .NET Framework-Remotinginfrastruktur.

ObjectHandle

Umschließt als Wert gemarshallte Objektverweise, sodass sie durch eine Dereferenzierung zurückgegeben werden können.

ObjRef

Speichert alle relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind.

RemotingConfiguration

Stellt verschiedene statische Methoden zum Konfigurieren der Remotinginfrastruktur bereit.

RemotingException

Die Ausnahme, die bei einem Remoting-Fehler ausgelöst wird.

RemotingServices

Stellt verschiedene 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 nicht innerhalb einer vorher festgelegten Zeitspanne erreicht werden kann.

ServerException

Diese Ausnahme wird ausgelöst, um dem Client Fehler zu übermitteln, wenn dieser eine Verbindung mit nicht in .NET Framework erstellten Anwendungen herstellt, die selbst keine Ausnahmen auslösen können.

SoapServices

Stellt mehrere Methoden für die Verwendung und Veröffentlichung von Remoteobjekten im SOAP-Format bereit.

TypeEntry

Implementiert eine Basisklasse, die die Konfigurationsinformationen zum Aktivieren einer Instanz eines Remotetyps enthält.

WellKnownClientTypeEntry

Enthält Werte für einen Objekttyp, der beim Client als vom Server aktivierter Typ (Einzelaufruf oder Singleton) registriert ist.

WellKnownServiceTypeEntry

Enthält Werte für einen Objekttyp, der auf der Dienstseite als Objekt eines vom Server aktivierten Typs (Einzelaufruf oder Singleton) registriert ist.

Schnittstellen

IChannelInfo

Stellt benutzerdefinierte Channelinformationen zur Verfügung, die zusammen mit der ObjRef übertragen werden.

IEnvoyInfo

Stellt Boteninformationen bereit.

IObjectHandle

Definiert die Schnittstelle zum Entwrappen von als Wert gemarshallten Objekten aus der Dereferenzierung.

IRemotingTypeInfo

Stellt Typinformationen für ein Objekt bereit.

Enumerationen

CustomErrorsModes

Gibt an, wie benutzerdefinierte Fehler behandelt werden.

WellKnownObjectMode

Definiert, auf welche Weise bekannte Objekte aktiviert werden.

Hinweise

Die- RemotingConfiguration Klasse enthält statische Methoden für die Schnittstellen mit Konfigurationseinstellungen. Die- RemotingConfiguration.Configure Methode ermöglicht es Entwicklern, die Remoting-Infrastruktur durch die Verwendung von XML-formatierten Konfigurationsdateien zu konfigurieren. Die RemotingConfiguration -Klasse enthält auch mehrere Methoden für die Client-und Server-End-Registrierung von Client-und Server aktivierten Objekten, die sich auf dem Server befinden.

Die RemotingServices -Klasse stellt eine Reihe von Methoden bereit, um die Verwendung und Veröffentlichung von remoten Objekten zu erleichtern. Die- RemotingServices.Marshal Methode bietet die Funktionalität zum Speichern aller relevanten Informationen, die erforderlich sind, um ein Remote Objekt in einer Instanz der- ObjRef Klasse für die spätere Serialisierung und Übertragung an einen Remote Speicherort zu aktivieren und mit ihm zu kommunizieren. Die- RemotingServices.Unmarshal Methode kehrt diesen Prozess um und erstellt einen Proxy für ein Remote Objekt, das von einer Anwendung ohne Berücksichtigung von Remoting-Unterteilungen verwendet werden kann.

Die ObjRef -Klasse enthält alle relevanten Informationen, die erforderlich sind, um ein Remote Objekt zu aktivieren und mit ihm zu kommunizieren. Bei dieser Klasse handelt es sich um eine serialisierbare Darstellung eines Objekts, das über einen Kanal an einen Remote Speicherort übertragen wird (siehe Unmarshal ) und zum Erstellen eines lokalen Proxys für das Remote Objekt verwendet werden kann.

Hinweis

Marshal-by-Reference-Objekte (MBRs) befinden sich nicht immer im Arbeitsspeicher. Es sei denn, der Typ überschreibt, MarshalByRefObject.InitializeLifetimeService um seine eigenen Lebensdauer Richtlinien zu steuern, hat jeder MBR eine endliche Lebensdauer, bevor das .NET Framework Remoting-System den Löschvorgang für den Prozess startet und den Speicher freigibt. Weitere Informationen finden Sie unter Lebensdauer-Leases.