ChannelServices.RegisterChannel Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Overloads
| Name | Description |
|---|---|
| RegisterChannel(IChannel) |
Verouderd.
Registreert een kanaal bij de kanaalservices. RegisterChannel(IChannel) is verouderd. Gebruik in plaats daarvan RegisterChannel(IChannel, Boolean). |
| RegisterChannel(IChannel, Boolean) |
Registreert een kanaal bij de kanaalservices. |
RegisterChannel(IChannel)
Let op
Use System.Runtime.Remoting.ChannelServices.RegisterChannel(IChannel chnl, bool ensureSecurity) instead.
Registreert een kanaal bij de kanaalservices. RegisterChannel(IChannel) is verouderd. Gebruik in plaats daarvan 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)Parameters
- chnl
- IChannel
Het kanaal dat moet worden geregistreerd.
- Kenmerken
Uitzonderingen
De chnl parameter is null.
Het kanaal is al geregistreerd.
Ten minste één van de bellers hoger in de callstack is niet gemachtigd om externe typen en kanalen te configureren.
Opmerkingen
Note
RegisterChannel(IChannel) is verouderd. Gebruik in plaats daarvan RegisterChannel(IChannel, Boolean).
De RegisterChannel methode neemt de IChannel interface van een kanaalobject in beslag. De kanalen ChannelName moeten uniek zijn of het kanaal moet anoniem zijn. Een kanaal is anoniem als het IChannel.ChannelName is ingesteld op null of Empty met behulp van de name configuratie-eigenschap.
U kunt geen twee kanalen met dezelfde naam registreren in een AppDomain. Standaard is de naam van een HttpChannel 'http' en de naam van een TcpChannel 'tcp'. Als u daarom twee kanalen van hetzelfde type wilt registreren, moet u een andere naam voor een van deze kanalen opgeven via configuratie-eigenschappen.
Zie en <kanaalelement> (sjabloon) voor meer informatie over eigenschappen van kanaalconfiguratieHttpChannel.
Van toepassing op
RegisterChannel(IChannel, Boolean)
Registreert een kanaal bij de kanaalservices.
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)Parameters
- chnl
- IChannel
Het kanaal dat moet worden geregistreerd.
- ensureSecurity
- Boolean
true zorgt ervoor dat beveiliging is ingeschakeld; anders false. Het instellen van de waarde heeft false geen invloed op de beveiligingsinstelling op het TCP- of IPC-kanaal.
Uitzonderingen
De chnl parameter is null.
Het kanaal is al geregistreerd.
Ten minste één van de bellers hoger in de oproepstack is niet gemachtigd om externe typen en kanalen te configureren.
Niet ondersteund voor HttpServerChannel. Host de service met behulp van Internet Information Services (IIS) als u een beveiligd HTTP-kanaal nodig hebt.
Opmerkingen
De RegisterChannel(IChannel, Boolean) methode ontvangt de IChannel interface van een kanaalobject. De kanalen ChannelName moeten uniek zijn of het kanaal moet anoniem zijn. Een kanaal is anoniem als het IChannel.ChannelName is ingesteld op null of Empty met behulp van de name configuratie-eigenschap.
U kunt geen twee kanalen met dezelfde naam registreren in een AppDomain. Standaard is de naam van een HttpChannel 'http' en de naam van een TcpChannel 'tcp'. Als u daarom twee kanalen van hetzelfde type wilt registreren, moet u een andere naam voor een van deze kanalen opgeven via configuratie-eigenschappen.
Zie Eigenschappen van kanaal- en formatterconfiguratie en <kanaalelement> (sjabloon) voor meer informatie over eigenschappen van kanaalconfiguratie.
Als de ensureSecurity parameter is ingesteld trueop , bepaalt het externe systeem of het kanaal implementeert ISecurableChannel, en zo ja, versleuteling en digitale handtekeningen inschakelen. Er wordt een uitzondering gegenereerd als het kanaal niet wordt geïmplementeerd ISecurableChannel.
Note
Instelling ensureSecurity om true een RemotingException voor het HttpServerChannel kanaal op alle platforms te gooien. U moet uw service hosten in IIS als u een beveiligd HTTP-kanaal wilt gebruiken.