ChannelServices.RegisterChannel Méthode
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.
Surcharges
| Nom | Description |
|---|---|
| RegisterChannel(IChannel) |
Obsolète.
Inscrit un canal auprès des services de canal. RegisterChannel(IChannel) est obsolète. Utilisez plutôt RegisterChannel(IChannel, Boolean). |
| RegisterChannel(IChannel, Boolean) |
Inscrit un canal auprès des services de canal. |
RegisterChannel(IChannel)
Attention
Use System.Runtime.Remoting.ChannelServices.RegisterChannel(IChannel chnl, bool ensureSecurity) instead.
Inscrit un canal auprès des services de canal. RegisterChannel(IChannel) est obsolète. Utilisez plutôt RegisterChannel(IChannel, Boolean).
public:
static void RegisterChannel(System::Runtime::Remoting::Channels::IChannel ^ chnl);public static void RegisterChannel(System.Runtime.Remoting.Channels.IChannel chnl);[System.Obsolete("Use System.Runtime.Remoting.ChannelServices.RegisterChannel(IChannel chnl, bool ensureSecurity) instead.", false)]
public static void RegisterChannel(System.Runtime.Remoting.Channels.IChannel chnl);static member RegisterChannel : System.Runtime.Remoting.Channels.IChannel -> unit[<System.Obsolete("Use System.Runtime.Remoting.ChannelServices.RegisterChannel(IChannel chnl, bool ensureSecurity) instead.", false)>]
static member RegisterChannel : System.Runtime.Remoting.Channels.IChannel -> unitPublic Shared Sub RegisterChannel (chnl As IChannel)Paramètres
- chnl
- IChannel
Canal à inscrire.
- Attributs
Exceptions
Le chnl paramètre est null.
Le canal a déjà été inscrit.
Au moins un des appelants plus haut dans la pile d’appels n’est pas autorisé à configurer les types et canaux de communication à distance.
Remarques
Note
RegisterChannel(IChannel) est obsolète. Utilisez plutôt RegisterChannel(IChannel, Boolean).
La RegisterChannel méthode prend l’interface IChannel à partir d’un objet de canal. Le canal ChannelName doit être unique, ou le canal doit être anonyme. Un canal est anonyme si celui-ci IChannel.ChannelName est défini sur Empty ou null à l’aide de la name propriété de configuration.
Vous ne pouvez pas inscrire deux canaux portant le même nom dans un AppDomain. Par défaut, le nom d’un HttpChannel est « http » et le nom d’un TcpChannel « tcp ». Par conséquent, si vous souhaitez inscrire deux canaux du même type, vous devez spécifier un nom différent pour l’un d’entre eux via des propriétés de configuration.
Pour plus d’informations sur les propriétés de configuration de canal, consultez HttpChannel.
S’applique à
RegisterChannel(IChannel, Boolean)
Inscrit un canal auprès des services de canal.
public:
static void RegisterChannel(System::Runtime::Remoting::Channels::IChannel ^ chnl, bool ensureSecurity);public static void RegisterChannel(System.Runtime.Remoting.Channels.IChannel chnl, bool ensureSecurity);static member RegisterChannel : System.Runtime.Remoting.Channels.IChannel * bool -> unitPublic Shared Sub RegisterChannel (chnl As IChannel, ensureSecurity As Boolean)Paramètres
- chnl
- IChannel
Canal à inscrire.
- ensureSecurity
- Boolean
true garantit que la sécurité est activée ; sinon false. La définition de la valeur pour false ne pas affecter le paramètre de sécurité sur le canal TCP ou IPC.
Exceptions
Le chnl paramètre est null.
Le canal a déjà été inscrit.
Au moins un des appelants plus haut dans la pile des appels n’est pas autorisé à configurer les types et canaux de communication à distance.
Non pris en charge pour HttpServerChannel. Hébergez le service à l’aide de Internet Information Services (IIS) si vous avez besoin d’un canal HTTP sécurisé.
Remarques
La RegisterChannel(IChannel, Boolean) méthode reçoit l’interface IChannel à partir d’un objet de canal. Le canal ChannelName doit être unique, ou le canal doit être anonyme. Un canal est anonyme si celui-ci IChannel.ChannelName est défini sur Empty ou null à l’aide de la name propriété de configuration.
Vous ne pouvez pas inscrire deux canaux portant le même nom dans un AppDomain. Par défaut, le nom d’un HttpChannel est « http » et le nom d’un TcpChannel « tcp ». Par conséquent, si vous souhaitez inscrire deux canaux du même type, vous devez spécifier un nom différent pour l’un d’entre eux via des propriétés de configuration.
Si le ensureSecurity paramètre est défini truesur , le système de communication à distance détermine si le canal implémente ISecurableChannel, et le cas échéant, active le chiffrement et les signatures numériques. Une exception est levée si le canal n’implémente ISecurableChannelpas .
Note
Paramètre ensureSecurity permettant de true lever une RemotingException pour le HttpServerChannel canal sur toutes les plateformes. Vous devez héberger votre service dans IIS si vous souhaitez utiliser un canal http sécurisé.
