ChannelServices.RegisterChannel Méthode

Définition

Espace de noms:

System.Runtime.Remoting.Channels

Assembly:

mscorlib.dll

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);

[System.Obsolete("Use System.Runtime.Remoting.ChannelServices.RegisterChannel(IChannel chnl, bool ensureSecurity) instead.", false)]
public static void RegisterChannel (System.Runtime.Remoting.Channels.IChannel chnl);

[<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

ObsoleteAttribute

Exceptions

ArgumentNullException

Le paramètre chnl a la valeur null.

RemotingException

Le canal a déjà été inscrit.

SecurityException

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).

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

ArgumentNullException

Le paramètre chnl a la valeur null.

RemotingException

Le canal a déjà été inscrit.

SecurityException

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

NotSupportedException

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