Freigeben über


ChannelServices.RegisterChannel Methode

Definition

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

Gilt für: