ChannelServices Classe

Définition

Fournit des méthodes statiques pour faciliter l'inscription, la résolution et la découverte d'URL d'un canal de communication à distance.Provides static methods to aid with remoting channel registration, resolution, and URL discovery. Cette classe ne peut pas être héritée.This class cannot be inherited.

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 dans des limites de communication à distance telles que les domaines d’application, les processus et les ordinateurs.Channels transport messages between applications across such remoting boundaries as application domains, processes, and computers. Ces intersections peuvent être entrantes et sortantes.These crossings can be inbound and outbound. Un canal peut écouter un point de terminaison pour les messages entrants, l’envoyer à un point de terminaison pour les messages sortants, ou les deux.A channel can listen on an endpoint for inbound messages, send to an endpoint for outbound messages, or both. Cela fournit un point d’extensibilité dans le runtime pour intégrer un large éventail de protocoles, même si le runtime n’est peut-être pas à l’autre extrémité du canal.This provides an extensibility point in the runtime to plug in a wide range of protocols, even though the runtime might not be at the other end of the channel. Les objets d’exécution peuvent être utilisés pour exposer un large éventail d’entités et de sémantiques.Run-time objects can be used to expose a wide range of semantics and entities. Le canal fournit le point d’extensibilité pour convertir les messages vers et à partir des protocoles spécifiques.The channel provides the extensibility point to convert the messages to and from the specific protocols.

Les canaux doivent exposer l' IChannel interface, qui fournit des propriétés d’information telles que ChannelName et ChannelPriority .Channels must expose the IChannel interface, which provides informational properties such as the ChannelName and ChannelPriority. Les canaux sont inscrits à l’aide de la ChannelServices.RegisterChannel méthode.Channels are registered using the ChannelServices.RegisterChannel method. Les canaux peuvent également être chargés à partir de la configuration de communication à distance.Channels can also be loaded from the remoting configuration. (Pour plus d’informations, consultez l' <channel> élément (modèle) .)(See <channel> Element (Template) for details.)

Côté client, les messages sont transmis à la chaîne de récepteurs de canal client après avoir parcouru la chaîne du client Context .On the client side, messages are handed off to the client channel sink chain after they traverse the client Context chain. Le premier récepteur de canal est généralement un IClientFormatterSink , qui sérialise le message dans un flux qui est passé dans la chaîne du récepteur de canal au récepteur de transport client.The first channel sink is typically a IClientFormatterSink, which serializes the message into a stream that is passed down the channel sink chain to the client transport sink. Le récepteur de transport client écrit ensuite ce flux et le transmet.The client transport sink then writes this stream out to the wire.

Côté serveur, le récepteur de transport serveur lit les demandes en provenance du réseau et transmet le flux de demande à la chaîne du récepteur de canal serveur.On the server side, the server transport sink reads requests off the wire and passes the request stream to the server channel sink chain. Le récepteur de formateur serveur à la fin de cette chaîne désérialise la requête dans un message.The server formatter sink at the end of this chain will deserialize the request into a message. Il remet ensuite ce message à l’infrastructure de communication à distance, qui le distribue à la Context chaîne de serveurs.It will then hand this message off to the remoting infrastructure, which will dispatch it to the server Context chain.

Propriétés

RegisteredChannels

Obtient une liste des canaux actuellement inscrits.Gets a list of currently registered channels.

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.Asynchronously dispatches the given message to the server-side chain(s) based on the URI embedded in the message.

CreateServerChannelSinkChain(IServerChannelSinkProvider, IChannelReceiver)

Crée une chaîne de récepteurs de canal pour le canal spécifié.Creates a channel sink chain for the specified channel.

DispatchMessage(IServerChannelSinkStack, IMessage, IMessage)

Distribue les appels distants entrants.Dispatches incoming remote calls.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetChannel(String)

Retourne un canal inscrit avec le nom spécifié.Returns a registered channel with the specified name.

GetChannelSinkProperties(Object)

Retourne un IDictionary de propriétés pour un proxy donné.Returns a IDictionary of properties for a given proxy.

GetHashCode()

Sert de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
GetUrlsForObject(MarshalByRefObject)

Retourne un tableau de toutes les URL qui peuvent être utilisées pour atteindre l'objet spécifié.Returns an array of all the URLs that can be used to reach the specified object.

MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
RegisterChannel(IChannel)
Obsolète.
Obsolète.

Inscrit un canal avec Channel Services.Registers a channel with the channel services. RegisterChannel(IChannel) est obsolète.RegisterChannel(IChannel) is obsolete. Utilisez plutôt RegisterChannel(IChannel, Boolean).Please use RegisterChannel(IChannel, Boolean) instead.

RegisterChannel(IChannel, Boolean)

Inscrit un canal avec Channel Services.Registers a channel with the 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.Synchronously dispatches the incoming message to the server-side chain(s) based on the URI embedded in the message.

ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Hérité de Object)
UnregisterChannel(IChannel)

Annule l'inscription d'un canal particulier de la liste des canaux inscrits.Unregisters a particular channel from the registered channels list.

S’applique à

Voir aussi