ChannelServices.RegisterChannel Metoda

Definice

Obor názvů:

System.Runtime.Remoting.Channels

Sestavení:

mscorlib.dll

Přetížení

Name	Description
RegisterChannel(IChannel)	Zastaralé. Zaregistruje kanál ve službách kanálu. RegisterChannel(IChannel) je zastaralá. Místo toho použijte RegisterChannel(IChannel, Boolean) .
RegisterChannel(IChannel, Boolean)	Zaregistruje kanál ve službách kanálu.

RegisterChannel(IChannel)

Upozornění

Use System.Runtime.Remoting.ChannelServices.RegisterChannel(IChannel chnl, bool ensureSecurity) instead.

Zaregistruje kanál ve službách kanálu. RegisterChannel(IChannel) je zastaralá. Místo toho použijte 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)

Parametry

chnl

IChannel

Kanál, který se má zaregistrovat.

Atributy

ObsoleteAttribute

Výjimky

ArgumentNullException

Parametr chnl je null.

RemotingException

Kanál už je zaregistrovaný.

SecurityException

Alespoň jeden z volajících, kteří jsou ve volání vyšší, nemá oprávnění ke konfiguraci typů vzdálené komunikace a kanálů.

Poznámky

Poznámka:

RegisterChannel(IChannel) je zastaralá. Místo toho použijte RegisterChannel(IChannel, Boolean) .

Metoda RegisterChannel přebírá rozhraní z objektu IChannel kanálu. Kanál ChannelName musí být jedinečný nebo musí být anonymní. Kanál je anonymní, pokud IChannel.ChannelName je nastaven na buď null nebo Empty pomocí name vlastnosti konfigurace.

Nelze zaregistrovat dva kanály se stejným názvem v objektu AppDomain. Ve výchozím nastavení je název HttpChannel "http" a název TcpChannel "tcp". Proto pokud chcete zaregistrovat dva kanály stejného typu, musíte pro jeden z nich zadat jiný název prostřednictvím vlastností konfigurace.

Další informace o vlastnostech konfigurace kanálu naleznete v tématu HttpChannel.

RegisterChannel(IChannel, Boolean)

Zaregistruje kanál ve službách kanálu.

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)

Parametry

chnl

IChannel

Kanál, který se má zaregistrovat.

ensureSecurity

Boolean

true zajišťuje, že je povoleno zabezpečení; jinak false. Nastavení hodnoty nemá vliv na false nastavení zabezpečení v kanálu TCP nebo IPC.

Výjimky

ArgumentNullException

Parametr chnl je null.

RemotingException

Kanál už je zaregistrovaný.

SecurityException

Alespoň jeden z volajících vyšší v zásobníku volání nemá oprávnění ke konfiguraci typů vzdálené komunikace a kanálů.

NotSupportedException

Nepodporuje se pro HttpServerChannel. Pokud potřebujete zabezpečený kanál HTTP, hostujte službu pomocí služby Internetové Informační Služby (IIS).

Poznámky

Metoda RegisterChannel(IChannel, Boolean) přijímá rozhraní z objektu IChannel kanálu. Kanál ChannelName musí být jedinečný nebo musí být anonymní. Kanál je anonymní, pokud IChannel.ChannelName je nastaven na buď null nebo Empty pomocí name vlastnosti konfigurace.

Nelze zaregistrovat dva kanály se stejným názvem v objektu AppDomain. Ve výchozím nastavení je název HttpChannel "http" a název TcpChannel "tcp". Proto pokud chcete zaregistrovat dva kanály stejného typu, musíte pro jeden z nich zadat jiný název prostřednictvím vlastností konfigurace.

ensureSecurity Pokud je parametr nastaven na true, systém vzdálené komunikace určuje, zda kanál implementuje ISecurableChannel, a pokud ano, povolí šifrování a digitální podpisy. Výjimka je vyvolán, pokud kanál neimplementuje ISecurableChannel.

Poznámka:

Nastavení ensureSecurity pro true vyvolání RemotingExceptionHttpServerChannel kanálu na všech platformách. Pokud chcete používat zabezpečený kanál HTTP, musíte službu hostovat ve službě IIS.