ChannelServices.RegisterChannel Metoda

Definice

Obor názvů:

System.Runtime.Remoting.Channels

Sestavení:

mscorlib.dll

Přetížení

RegisterChannel(IChannel)	Zastaralé. Zaregistruje kanál se službami kanálu. RegisterChannel(IChannel) je zastaralý. Použijte místo toho prosím .RegisterChannel(IChannel, Boolean)
RegisterChannel(IChannel, Boolean)	Zaregistruje kanál se službami kanálu.

RegisterChannel(IChannel)

Upozornění

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

Zaregistruje kanál se službami kanálu. RegisterChannel(IChannel) je zastaralý. Použijte místo toho prosím .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 výše v kanálu volání, nemá oprávnění ke konfiguraci typů vzdálené komunikace a kanálů.

Příklady

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

Poznámky

Poznámka

RegisterChannel(IChannel) je zastaralý. Použijte místo toho prosím .RegisterChannel(IChannel, Boolean)

Metoda RegisterChannel přebírá IChannel rozhraní z objektu 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 nebo nullEmpty pomocí name vlastnosti konfigurace.

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

Další informace o vlastnostech konfigurace kanálu najdete v tématu HttpChannel, a <element kanálu> (šablona).

RegisterChannel(IChannel, Boolean)

Zaregistruje kanál se službami 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, aby bylo povoleno zabezpečení; jinak false. Nastavení hodnoty na false nemá vliv na nastavení zabezpečení 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 výše 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í Internetové informační služby (IIS).

Poznámky

Metoda RegisterChannel(IChannel, Boolean) přijímá IChannel rozhraní z objektu 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 nebo nullEmpty pomocí name vlastnosti konfigurace.

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

Další informace o vlastnostech konfigurace kanálu najdete v tématu Vlastnosti konfigurace kanálu a formátovače a <element kanálu> (šablona) .

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

Poznámka

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