ChannelServices.RegisterChannel Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
| Name | Beschreibung |
|---|---|
| RegisterChannel(IChannel) |
Veraltet.
Registriert einen Kanal mit den Kanaldiensten. RegisterChannel(IChannel) ist veraltet. Verwenden Sie stattdessen RegisterChannel(IChannel, Boolean). |
| RegisterChannel(IChannel, Boolean) |
Registriert einen Kanal mit den Kanaldiensten. |
RegisterChannel(IChannel)
Achtung
Use System.Runtime.Remoting.ChannelServices.RegisterChannel(IChannel chnl, bool ensureSecurity) instead.
Registriert einen Kanal mit den Kanaldiensten. RegisterChannel(IChannel) ist veraltet. Verwenden Sie stattdessen 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)
Parameter
- chnl
- IChannel
Der zu registrierende Kanal.
- Attribute
Ausnahmen
Der chnl Parameter ist null.
Der Kanal wurde bereits registriert.
Mindestens einer der Anrufer im Callstack verfügt nicht über die Berechtigung zum Konfigurieren von Remotingtypen und Kanälen.
Hinweise
Hinweis
RegisterChannel(IChannel) ist veraltet. Verwenden Sie stattdessen RegisterChannel(IChannel, Boolean).
Die RegisterChannel Methode verwendet die IChannel Schnittstelle aus einem Kanalobjekt. Der Kanal ChannelName muss eindeutig sein, oder der Kanal muss anonym sein. Ein Kanal ist anonym, wenn die IChannel.ChannelName Einstellung entweder null oder Empty mithilfe der name Konfigurationseigenschaft erfolgt.
Sie können nicht zwei Kanäle mit demselben Namen in einem AppDomain. Standardmäßig lautet der Name eines HttpChannel "http" und der Name eines TcpChannel "tcp". Wenn Sie daher zwei Kanäle desselben Typs registrieren möchten, müssen Sie einen anderen Namen für einen dieser Kanäle über Konfigurationseigenschaften angeben.
Weitere Informationen zu Kanalkonfigurationseigenschaften finden Sie unter HttpChannel.
Gilt für:
RegisterChannel(IChannel, Boolean)
Registriert einen Kanal mit den Kanaldiensten.
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)
Parameter
- chnl
- IChannel
Der zu registrierende Kanal.
- ensureSecurity
- Boolean
true stellt sicher, dass die Sicherheit aktiviert ist; andernfalls false. Durch Festlegen des Werts wird false die Sicherheitseinstellung für den TCP- oder IPC-Kanal nicht wirksam.
Ausnahmen
Der chnl Parameter ist null.
Der Kanal wurde bereits registriert.
Mindestens einer der Anrufer im Anrufstapel verfügt nicht über die Berechtigung zum Konfigurieren von Remotingtypen und Kanälen.
Nicht unterstützt für HttpServerChannel. Hosten Sie den Dienst mithilfe von Internetinformationsdienste (IIS), wenn Sie einen sicheren HTTP-Kanal benötigen.
Hinweise
Die RegisterChannel(IChannel, Boolean) Methode empfängt die IChannel Schnittstelle von einem Kanalobjekt. Der Kanal ChannelName muss eindeutig sein, oder der Kanal muss anonym sein. Ein Kanal ist anonym, wenn die IChannel.ChannelName Einstellung entweder null oder Empty mithilfe der name Konfigurationseigenschaft erfolgt.
Sie können nicht zwei Kanäle mit demselben Namen in einem AppDomain. Standardmäßig ist der Name eines HttpChannel "http" und der Name eines TcpChannel "tcp". Wenn Sie daher zwei Kanäle desselben Typs registrieren möchten, müssen Sie einen anderen Namen für einen dieser Kanäle über Konfigurationseigenschaften angeben.
Wenn der ensureSecurity Parameter auf true festgelegt ist, bestimmt das Remotingsystem, ob der Kanal implementiert ISecurableChannelwird und falls ja, Verschlüsselung und digitale Signaturen aktiviert. Eine Ausnahme wird ausgelöst, wenn der Kanal nicht implementiert ISecurableChannelwird.
Hinweis
Die Einstellung ensureSecurity zum true Auslösen eines RemotingExceptionHttpServerChannel Kanals auf allen Plattformen. Sie müssen Ihren Dienst in IIS hosten, wenn Sie einen sicheren HTTP-Kanal verwenden möchten.