System.Runtime.Remoting Espace de noms

Fournit des classes et des interfaces qui permettent aux développeurs de créer et configurer des applications distribuées. Certaines des classes les plus importantes de l’espace de noms System.Runtime.Remoting sont les classes RemotingConfiguration, RemotingServices et ObjRef.

Classes

ActivatedClientTypeEntry

Contient les valeurs d'un type d'objets inscrit côté client en tant que type pouvant être activé sur le serveur.

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.

InternalRemotingServices

Définit les méthodes utilitaires qu'utilise l'infrastructure .NET Framework Remoting.

ObjectHandle

Encapsule les références d'objets marshalés par valeur pour autoriser leur retour via une indirection.

ObjRef

Stocke toutes les informations appropriées requises pour générer un proxy permettant de communiquer avec un objet distant.

RemotingConfiguration

Fournit différentes méthodes statiques pour configurer l'infrastructure de communication à distance.

RemotingException

Exception qui est levée quand une erreur s'est produite au cours de la communication à distance.

RemotingServices

Fournit plusieurs méthodes pour utiliser et publier des objets et proxies distants. Cette classe ne peut pas être héritée.

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.

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.

SoapServices

Fournit plusieurs méthodes pour l'utilisation et la publication d'objets distants au format SOAP.

TypeEntry

Implémente une classe de base qui contient les informations de configuration utilisées pour activer une instance d'un type distant.

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

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

Interfaces

IChannelInfo

Fournit des informations de canal personnalisées qui sont acheminées avec ObjRef.

IEnvoyInfo

Fournit des informations d'envoi.

IObjectHandle

Définit l'interface permettant de désencapsuler les objets marshalés par valeur à partir d'une indirection.

IRemotingTypeInfo

Fournit des informations de type pour un objet.

Énumérations

CustomErrorsModes

Spécifie la façon dont les erreurs personnalisées sont gérées.

WellKnownObjectMode

Définit comment les objets connus sont activés.

Remarques

La RemotingConfiguration classe contient des méthodes statiques pour l’interfaçage avec les paramètres de configuration. La RemotingConfiguration.Configure méthode permet aux développeurs de configurer l’infrastructure de communication à distance à l’aide de fichiers de configuration au format XML. La RemotingConfiguration classe contient également plusieurs méthodes pour l’inscription côté client et de fin serveur des objets activés par le client et le serveur qui résident sur le serveur.

La RemotingServices classe fournit un certain nombre de méthodes pour vous aider à utiliser et à publier des objets distants. La RemotingServices.Marshal méthode fournit les fonctionnalités pour le stockage de toutes les informations pertinentes requises pour activer et communiquer avec un objet distant dans une instance de la ObjRef classe pour une sérialisation et une transmission ultérieures vers un emplacement distant. La 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.

La ObjRef classe contient toutes les informations pertinentes requises pour activer et communiquer avec un objet distant. 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 qui peut être utilisé pour créer un proxy local de l’objet distant.

Notes

Les objets marshalés par référence (MBR) ne résident pas indéfiniment en mémoire. Au lieu de cela, à moins que le type ne se substitue MarshalByRefObject.InitializeLifetimeService pour contrôler ses propres stratégies de durée de vie, chaque MBR a une durée de vie limitée avant que le .NET Framework système de communication à distance commence le processus de suppression et de récupération de la mémoire. Pour plus d’informations, consultez baux de durée de vie.