Partager via


ChannelServices.RegisterChannel Méthode

Définition

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 -> unit
Public 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 -> unit
Public 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é.

S’applique à