System.Runtime.Remoting Espace de noms

L’espace de noms System.Runtime.Remoting fournit des classes et des interfaces qui permettent aux développeurs de créer et configurer des applications distribuées. The System.Runtime.Remoting namespace provides classes and interfaces that allow developers to create and configure distributed applications. Certaines des classes les plus importantes de l’espace de noms System.Runtime.Remoting sont les classes RemotingConfiguration, RemotingServices et ObjRef. Some of the more important classes of the System.Runtime.Remoting namespace are the RemotingConfiguration class, the RemotingServices class, and the ObjRef class.

Classes

ActivatedClientTypeEntry

Contient les valeurs d'un type d'objets inscrit côté client en tant que type pouvant être activé sur le serveur.Holds values for an object type registered on the client end as a type that can be activated on the server.

ActivatedServiceTypeEntry

Contient les valeurs d'un type d'objet inscrit côté service en tant que type pouvant être activé sur demande par un client.Holds values for an object type registered on the service end as one that can be activated on request from a client.

InternalRemotingServices

Définit les méthodes utilitaires qu'utilise l'infrastructure .NET Framework Remoting.Defines utility methods for use by the .NET Framework remoting infrastructure.

ObjectHandle

Encapsule les références d'objets marshalés par valeur pour autoriser leur retour via une indirection.Wraps marshal-by-value object references, allowing them to be returned through an indirection.

ObjRef

Stocke toutes les informations appropriées requises pour générer un proxy permettant de communiquer avec un objet distant.Stores all relevant information required to generate a proxy in order to communicate with a remote object.

RemotingConfiguration

Fournit différentes méthodes statiques pour configurer l'infrastructure de communication à distance.Provides various static methods for configuring the remoting infrastructure.

RemotingException

Exception qui est levée quand une erreur s'est produite au cours de la communication à distance.The exception that is thrown when something has gone wrong during remoting.

RemotingServices

Fournit plusieurs méthodes pour utiliser et publier des objets et proxies distants.Provides several methods for using and publishing remoted objects and proxies. Cette classe ne peut pas être héritée.This class cannot be inherited.

RemotingTimeoutException

Exception qui est levée lorsqu'il est impossible d'atteindre le serveur ou le client pendant une période spécifiée au préalable.The exception that is thrown when the server or the client cannot be reached for a previously specified period of time.

ServerException

Exception levée pour communiquer des erreurs au client lorsque celui-ci se connecte à des applications autres que des applications .NET Framework, qui ne peuvent pas lever d'exceptions.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

Fournit plusieurs méthodes pour l'utilisation et la publication d'objets distants au format SOAP.Provides several methods for using and publishing remoted objects in SOAP format.

TypeEntry

Implémente une classe de base qui contient les informations de configuration utilisées pour activer une instance d'un type distant.Implements a base class that holds the configuration information used to activate an instance of a remote type.

WellKnownClientTypeEntry

Contient les valeurs d'un type d'objet inscrit sur le client en tant que type activé par le serveur (appel simple ou singleton).Holds values for an object type registered on the client as a server-activated type (single call or singleton).

WellKnownServiceTypeEntry

Contient les valeurs d'un type d'objet inscrit sur le service en tant qu'objet de type activé par le serveur (appel simple ou singleton).Holds values for an object type registered on the service end as a server-activated type object (single call or singleton).

Interfaces

IChannelInfo

Fournit des informations de canal personnalisées qui sont acheminées avec ObjRef.Provides custom channel information that is carried along with the ObjRef.

IEnvoyInfo

Fournit des informations d'envoi.Provides envoy information.

IObjectHandle

Définit l'interface permettant de désencapsuler les objets marshalés par valeur à partir d'une indirection.Defines the interface for unwrapping marshal-by-value objects from indirection.

IRemotingTypeInfo

Fournit des informations de type pour un objet.Provides type information for an object.

Énumérations

CustomErrorsModes

Spécifie la façon dont les erreurs personnalisées sont gérées.Specifies how custom errors are handled.

WellKnownObjectMode

Définit comment les objets connus sont activés.Defines how well-known objects are activated.

Remarques

Le RemotingConfiguration classe contient des méthodes statiques pour l’interface avec les paramètres de configuration.The RemotingConfiguration class contains static methods for interfacing with configuration settings. Le RemotingConfiguration.Configure méthode permet aux développeurs de configurer l’infrastructure de communication à distance via l’utilisation de fichiers de configuration au format XML.The RemotingConfiguration.Configure method allows developers to configure the remoting infrastructure through the use of XML formatted configuration files. Le RemotingConfiguration classe contient également plusieurs méthodes pour l’inscription à la fin de client et serveur principal du client et serveur activé les objets qui résident sur le serveur.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.

Le RemotingServices classe fournit plusieurs méthodes pour vous aider dans l’utilisation et la publication d’objets distants.The RemotingServices class provides a number of methods to help in using and publishing remoted objects. Le RemotingServices.Marshal méthode fournit les fonctionnalités pour enregistrer toutes les informations requises pour activer et communiquer avec un objet distant dans une instance de la ObjRef classe pour sérialisation ultérieure et de transmission vers un emplacement distant.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. Le RemotingServices.Unmarshal méthode inverse ce processus en créant un proxy pour un objet distant qui peut être utilisé par une application sans tenir compte des sous-divisions de communication à distance.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.

Le ObjRef classe contient toutes les informations requises pour activer et communiquer avec un objet distant.The ObjRef class holds all the relevant information required to activate and communicate with a remote object. Cette classe est une représentation sérialisable d’un objet qui est transmis à un emplacement distant à l’aide d’un canal, où il est démarshalé (consultez Unmarshal) et peut être utilisé pour créer un proxy local de l’objet distant.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.

Notes

Objets marshalés-par-référence (MBR) ne résident pas indéfiniment en mémoire.Marshal-by-reference objects (MBRs) do not reside in memory forever. Au lieu de cela, sauf si le type se substitue MarshalByRefObject.InitializeLifetimeService pour contrôler ses propres stratégies de durée de vie, chaque MBR dispose d’une durée de vie avant que le système .NET Framework remoting ne commence le processus de suppression et libère la mémoire.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. Pour plus d’informations, consultez baux de durée de vie.For more information, see Lifetime Leases.