System.Runtime.Remoting Namespace

Stellt Klassen und Schnittstellen bereit, die Entwicklern das Erstellen und Konfigurieren verteilter Anwendungen ermöglichen. Provides classes and interfaces that allow developers to create and configure distributed applications. Einige der wichtigeren Klassen des System.Runtime.Remoting-Namespaces sind die RemotingConfiguration-Klasse, die RemotingServices-Klasse und die ObjRef-Klasse. Some of the more important classes of the System.Runtime.Remoting namespace are the RemotingConfiguration class, the RemotingServices class, and the ObjRef class.

Klassen

ActivatedClientTypeEntry

Enthält Werte für einen Objekttyp, der auf der Clientseite als Typ registriert ist, der auf dem Server aktiviert werden kann.Holds values for an object type registered on the client end as a type that can be activated on the server.

ActivatedServiceTypeEntry

Enthält Werte für einen Objekttyp, der auf der Dienstseite als solcher registriert ist und auf Anforderung eines Clients aktiviert werden kann.Holds values for an object type registered on the service end as one that can be activated on request from a client.

InternalRemotingServices

Definiert Dienstmethoden für die Verwendung durch die .NET Framework-Remotinginfrastruktur.Defines utility methods for use by the .NET Framework remoting infrastructure.

ObjectHandle

Umschließt als Wert gemarshallte Objektverweise, sodass sie durch eine Dereferenzierung zurückgegeben werden können.Wraps marshal-by-value object references, allowing them to be returned through an indirection.

ObjRef

Speichert alle relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind. Stores all relevant information required to generate a proxy in order to communicate with a remote object.

RemotingConfiguration

Stellt verschiedene statische Methoden zum Konfigurieren der Remotinginfrastruktur bereit.Provides various static methods for configuring the remoting infrastructure.

RemotingException

Die Ausnahme, die bei einem Remoting-Fehler ausgelöst wird.The exception that is thrown when something has gone wrong during remoting.

RemotingServices

Stellt verschiedene Methoden zum Verwenden und Veröffentlichen von Remoteobjekten und -proxys bereit.Provides several methods for using and publishing remoted objects and proxies. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

RemotingTimeoutException

Die Ausnahme, die ausgelöst wird, wenn der Server oder der Client nicht innerhalb einer vorher festgelegten Zeitspanne erreicht werden kann.The exception that is thrown when the server or the client cannot be reached for a previously specified period of time.

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.The exception that is thrown to communicate errors to the client when the client connects to non-.NET Framework applications that cannot throw exceptions.

SoapServices

Stellt mehrere Methoden für die Verwendung und Veröffentlichung von Remoteobjekten im SOAP-Format bereit.Provides several methods for using and publishing remoted objects in SOAP format.

TypeEntry

Implementiert eine Basisklasse, die die Konfigurationsinformationen zum Aktivieren einer Instanz eines Remotetyps enthält.Implements a base class that holds the configuration information used to activate an instance of a remote type.

WellKnownClientTypeEntry

Enthält Werte für einen Objekttyp, der beim Client als vom Server aktivierter Typ (Einzelaufruf oder Singleton) registriert ist.Holds values for an object type registered on the client as a server-activated type (single call or singleton).

WellKnownServiceTypeEntry

Enthält Werte für einen Objekttyp, der auf der Dienstseite als Objekt eines vom Server aktivierten Typs (Einzelaufruf oder Singleton) registriert ist.Holds values for an object type registered on the service end as a server-activated type object (single call or singleton).

Schnittstellen

IChannelInfo

Stellt benutzerdefinierte Channelinformationen zur Verfügung, die zusammen mit der ObjRef übertragen werden.Provides custom channel information that is carried along with the ObjRef.

IEnvoyInfo

Stellt Boteninformationen bereit.Provides envoy information.

IObjectHandle

Definiert die Schnittstelle zum Entwrappen von als Wert gemarshallten Objekten aus der Dereferenzierung.Defines the interface for unwrapping marshal-by-value objects from indirection.

IRemotingTypeInfo

Stellt Typinformationen für ein Objekt bereit.Provides type information for an object.

Enumerationen

CustomErrorsModes

Gibt an, wie benutzerdefinierte Fehler behandelt werden.Specifies how custom errors are handled.

WellKnownObjectMode

Definiert, auf welche Weise bekannte Objekte aktiviert werden.Defines how well-known objects are activated.

Hinweise

Die- RemotingConfiguration Klasse enthält statische Methoden für die Schnittstellen mit Konfigurationseinstellungen.The RemotingConfiguration class contains static methods for interfacing with configuration settings. Die- RemotingConfiguration.Configure Methode ermöglicht es Entwicklern, die Remoting-Infrastruktur durch die Verwendung von XML-formatierten Konfigurationsdateien zu konfigurieren.The RemotingConfiguration.Configure method allows developers to configure the remoting infrastructure through the use of XML formatted configuration files. 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.The RemotingConfiguration class also contains several methods for client-end and server-end registration of client and server activated objects that reside on the server.

Die RemotingServices -Klasse stellt eine Reihe von Methoden bereit, um die Verwendung und Veröffentlichung von remoten Objekten zu erleichtern.The RemotingServices class provides a number of methods to help in using and publishing remoted objects. 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.The RemotingServices.Marshal method provides the functionality for storing all the relevant information required to activate and communicate with a remote object in an instance of the ObjRef class for later serialization and transmission to a remote location. 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.The RemotingServices.Unmarshal method reverses this process, creating a proxy for a remote object that can be used by an application without regard for any remoting subdivisions.

Die ObjRef -Klasse enthält alle relevanten Informationen, die erforderlich sind, um ein Remote Objekt zu aktivieren und mit ihm zu kommunizieren.The ObjRef class holds all the relevant information required to activate and communicate with a remote object. 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.This class is a serializable representation of an object that is transmitted to a remote location using a channel, where it is unmarshaled (see Unmarshal) and can be used to create a local proxy of the remoted object.

Hinweis

Marshal-by-Reference-Objekte (MBRs) befinden sich nicht immer im Arbeitsspeicher.Marshal-by-reference objects (MBRs) do not reside in memory forever. 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.Instead, unless the type overrides MarshalByRefObject.InitializeLifetimeService to control its own lifetime policies, each MBR has a finite lifetime before the .NET Framework remoting system begins the process of deleting it and reclaiming the memory. Weitere Informationen finden Sie unter Lebensdauer-Leases.For more information, see Lifetime Leases.