System.Runtime.Remoting Espace de noms
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Fournit des classes et des interfaces qui permettent aux développeurs de créer et de configurer des applications distribuées. Certaines des classes les plus importantes de l’espace System.Runtime.Remoting de noms sont la RemotingConfiguration classe, la RemotingServices classe et la ObjRef classe.
Classes
| Nom | Description |
|---|---|
| ActivatedClientTypeEntry |
Contient les valeurs d’un type d’objet inscrit à la fin du client en tant que type pouvant être activé sur le serveur. |
| ActivatedServiceTypeEntry |
Contient les valeurs d’un type d’objet inscrit sur la fin du service en tant qu’un type d’objet pouvant être activé à la demande d’un client. |
| InternalRemotingServices |
Définit les méthodes utilitaires à utiliser par l’infrastructure de communication à distance .NET Framework. |
| ObjectHandle |
Encapsule les références d’objet marshal-by-value, ce qui leur permet d’être retournées par le biais d’une indirection. |
| ObjRef |
Stocke toutes les informations pertinentes requises pour générer un proxy afin de communiquer avec un objet distant. |
| RemotingConfiguration |
Fournit différentes méthodes statiques pour configurer l’infrastructure de communication à distance. |
| RemotingException |
Exception levée lorsqu’un problème s’est produit lors de la communication à distance. |
| RemotingServices |
Fournit plusieurs méthodes pour l’utilisation et la publication d’objets distants et de proxys. Cette classe ne peut pas être héritée. |
| RemotingTimeoutException |
Exception levée lorsque le serveur ou le client ne peut pas être atteint pendant une période spécifiée précédemment. |
| ServerException |
Exception levée pour communiquer des erreurs au client lorsque le client se connecte à des applications non .NET Framework qui ne peuvent pas lever d’exceptions. |
| SoapServices |
Fournit plusieurs méthodes d’utilisation et de 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 unique ou singleton). |
| WellKnownServiceTypeEntry |
Contient les valeurs d’un type d’objet inscrit sur la fin du service en tant qu’objet de type activé par le serveur (appel unique ou singleton). |
Interfaces
| Nom | Description |
|---|---|
| IChannelInfo |
Fournit des informations de canal personnalisées qui sont transmises avec le ObjRef. |
| IEnvoyInfo |
Fournit des informations envoyées. |
| IObjectHandle |
Définit l’interface pour désencapsuler les objets marshal-by-value à partir d’indirection. |
| IRemotingTypeInfo |
Fournit des informations de type pour un objet. |
Énumérations
| Nom | Description |
|---|---|
| CustomErrorsModes |
Spécifie la façon dont les erreurs personnalisées sont gérées. |
| WellKnownObjectMode |
Définit la façon dont les objets connus sont activés. |
Remarques
La RemotingConfiguration classe contient des méthodes statiques pour interagir avec les paramètres de configuration. La 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. La RemotingConfiguration classe contient également plusieurs méthodes pour l’inscription de bout en bout de client et de serveur des objets clients et activés par le serveur qui résident sur le serveur.
La RemotingServices classe fournit un certain nombre de méthodes pour faciliter l’utilisation et la publication d’objets distants. La RemotingServices.Marshal méthode fournit la fonctionnalité permettant de stocker toutes les informations pertinentes requises pour activer et communiquer avec un objet distant dans une instance de la classe pour la sérialisation et la ObjRef transmission ultérieures vers un emplacement distant. La RemotingServices.Unmarshal méthode inverse ce processus, 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 transmis à un emplacement distant à l’aide d’un canal, où il est non délimité (voir Unmarshal) et peut être utilisé pour créer un proxy local de l’objet distant.
Note
Les objets marshal-by-reference (MBR) ne résident pas dans la mémoire pour toujours. Au lieu de cela, sauf si le type remplace 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 système de communication à distance .NET Framework commence le processus de suppression et de récupération de la mémoire.
