ChannelServices Classe
Définition
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 méthodes statiques pour faciliter l'inscription, la résolution et la découverte d'URL d'un canal de communication à distance. Cette classe ne peut pas être héritée.
public ref class ChannelServices sealed
public sealed class ChannelServices
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class ChannelServices
type ChannelServices = class
[<System.Runtime.InteropServices.ComVisible(true)>]
type ChannelServices = class
Public NotInheritable Class ChannelServices
- Héritage
-
ChannelServices
- Attributs
Remarques
Les canaux transportent les messages entre les applications au-delà des limites de communication à distance telles que les domaines d’application, les processus et les ordinateurs. Ces croisements peuvent être entrants et sortants. Un canal peut écouter sur un point de terminaison les messages entrants, les envoyer à un point de terminaison pour les messages sortants, ou les deux. Cela fournit un point d’extensibilité dans le runtime pour se connecter à un large éventail de protocoles, même si le runtime peut ne pas se trouver à l’autre extrémité du canal. Les objets d’exécution peuvent être utilisés pour exposer un large éventail de sémantiques et d’entités. Le canal fournit le point d’extensibilité pour convertir les messages vers et à partir des protocoles spécifiques.
Les canaux doivent exposer l’interface IChannel , qui fournit des propriétés d’information telles que et ChannelNameChannelPriority. Les canaux sont inscrits à l’aide de la ChannelServices.RegisterChannel méthode . Les canaux peuvent également être chargés à partir de la configuration de communication à distance. (Pour plus d’informations, consultez <Élément de canal> (modèle ).)
Côté client, les messages sont remis à la chaîne récepteur du canal client après avoir traversé la chaîne cliente Context . Le premier récepteur de canal est généralement un IClientFormatterSink, qui sérialise le message dans un flux qui est transmis par le bas de la chaîne du récepteur de canal au récepteur de transport client. Le récepteur de transport client écrit ensuite ce flux et le transmet.
Côté serveur, le récepteur de transport du serveur lit les requêtes hors du réseau et transmet le flux de requête à la chaîne récepteur du canal du serveur. Le récepteur du formateur de serveur à la fin de cette chaîne désérialise la demande en un message. Il transmet ensuite ce message à l’infrastructure de communication à distance, qui le distribuera à la chaîne du serveur Context .
Propriétés
RegisteredChannels |
Obtient une liste des canaux actuellement inscrits. |
Méthodes
AsyncDispatchMessage(IMessage, IMessageSink) |
Distribue de manière asynchrone le message donné aux chaînes côté serveur conformément à l'URI incorporé dans le message. |
CreateServerChannelSinkChain(IServerChannelSinkProvider, IChannelReceiver) |
Crée une chaîne de récepteurs de canal pour le canal spécifié. |
DispatchMessage(IServerChannelSinkStack, IMessage, IMessage) |
Distribue les appels distants entrants. |
Equals(Object) |
Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object) |
GetChannel(String) |
Retourne un canal inscrit avec le nom spécifié. |
GetChannelSinkProperties(Object) |
Retourne un IDictionary de propriétés pour un proxy donné. |
GetHashCode() |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
GetType() |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
GetUrlsForObject(MarshalByRefObject) |
Retourne un tableau de toutes les URL qui peuvent être utilisées pour atteindre l'objet spécifié. |
MemberwiseClone() |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
RegisterChannel(IChannel) |
Obsolète.
Inscrit un canal avec Channel Services. RegisterChannel(IChannel) est obsolète. Utilisez plutôt RegisterChannel(IChannel, Boolean). |
RegisterChannel(IChannel, Boolean) |
Inscrit un canal avec Channel Services. |
SyncDispatchMessage(IMessage) |
Distribue de manière synchrone le message entrant aux chaînes côté serveur conformément à l'URI incorporé dans le message. |
ToString() |
Retourne une chaîne qui représente l'objet actuel. (Hérité de Object) |
UnregisterChannel(IChannel) |
Annule l'inscription d'un canal particulier de la liste des canaux inscrits. |