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
| 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. |
RegisterChannel(IChannel)
Attention
Use System.Runtime.Remoting.ChannelServices.RegisterChannel(IChannel chnl, bool ensureSecurity) instead.
Inscrit un canal avec Channel Services. 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 paramètre chnl a la valeur null.
Le canal a déjà été inscrit.
Au moins un des appelants à un niveau plus élevé dans la pile des appels n'a pas l'autorisation de configuration des types et des canaux de communication à distance.
Exemples
HttpChannel^ channel = gcnew HttpChannel( 9000 );
ChannelServices::RegisterChannel( channel, false );
RemotingConfiguration::RegisterWellKnownServiceType( SampleNamespace::SampleService::typeid, "MySampleService/SampleService::soap", WellKnownObjectMode::Singleton );
Console::WriteLine( "** Press enter to end the server process. **" );
Console::ReadLine();
HttpChannel channel = new HttpChannel(9000);
ChannelServices.RegisterChannel(channel);
RemotingConfiguration.RegisterWellKnownServiceType( typeof(SampleService),
"MySampleService/SampleService.soap", WellKnownObjectMode.Singleton);
Console.WriteLine("** Press enter to end the server process. **");
Console.ReadLine();
Dim channel As New HttpChannel(9000)
ChannelServices.RegisterChannel(channel)
RemotingConfiguration.RegisterWellKnownServiceType(GetType(SampleService), "MySampleService/SampleService.soap", WellKnownObjectMode.Singleton)
Console.WriteLine("** Press enter to end the server process. **")
Console.ReadLine()
Remarques
Notes
RegisterChannel(IChannel) est obsolète. Utilisez plutôt RegisterChannel(IChannel, Boolean).
La RegisterChannel méthode accepte l’interface IChannel à partir d’un objet channel. Le canal ChannelName doit être unique ou le canal doit être anonyme. Un canal est anonyme si est défini null sur ou Empty à l’aide IChannel.ChannelName de la propriété de name 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 est « 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 les propriétés de configuration.
Pour plus d’informations sur les propriétés de configuration de canal, consultez HttpChannel, et <channel> Element (Template).
S’applique à
RegisterChannel(IChannel, Boolean)
Inscrit un canal avec Channel Services.
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. L'affectation de la valeur false n'effectue pas le paramètre de sécurité sur le canal TCP ou IPC.
Exceptions
Le paramètre chnl a la valeur null.
Le canal a déjà été inscrit.
Au moins un des appelants à un niveau plus élevé dans la pile des appels n'a pas l'autorisation requise pour configurer les canaux et les types de communication à distance
Non pris en charge pour HttpServerChannel. Hébergez le service à l'aide des services IIS (Internet Information Services) 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 channel. Le canal ChannelName doit être unique ou le canal doit être anonyme. Un canal est anonyme si est défini null sur ou Empty à l’aide IChannel.ChannelName de la propriété de name 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 est « 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 les propriétés de configuration.
Pour plus d’informations sur les propriétés de configuration de canal, consultez Propriétés de configuration du canal et du formateur et <élément de canal> (modèle).
Si le ensureSecurity paramètre est défini sur , le système de communication à truedistance détermine si le canal implémente ISecurableChannelet, le cas échéant, active le chiffrement et les signatures numériques. Une exception est levée si le canal n’implémente ISecurableChannelpas .
Notes
La définition ensureSecurity de true sur lève un 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é.
