ChannelServices.RegisterChannel Metodo

Definizione

Spazio dei nomi:

System.Runtime.Remoting.Channels

Assembly:

mscorlib.dll

Overload

RegisterChannel(IChannel)	Obsoleti. Registra un canale con i servizi dei canali. RegisterChannel(IChannel) è obsoleto. Usare invece RegisterChannel(IChannel, Boolean).
RegisterChannel(IChannel, Boolean)	Registra un canale con i servizi dei canali.

RegisterChannel(IChannel)

Attenzione

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

Registra un canale con i servizi dei canali. RegisterChannel(IChannel) è obsoleto. Usare invece 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)

Parametri

chnl

IChannel

Canale da registrare.

Attributi

ObsoleteAttribute

Eccezioni

ArgumentNullException

Il valore del parametro chnl è null.

RemotingException

Il canale è già stato registrato.

SecurityException

Almeno uno dei chiamanti in posizione più elevata nello stack di chiamate non dispone delle autorizzazioni alla configurazione di canali e tipi remoti.

Esempio

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

Commenti

Nota

RegisterChannel(IChannel) è obsoleto. Usare invece RegisterChannel(IChannel, Boolean).

Il RegisterChannel metodo accetta l'interfaccia IChannel da un oggetto channel. Il canale ChannelName deve essere univoco o il canale deve essere anonimo. Un canale è anonimo se l'oggetto IChannel.ChannelName è impostato su null o Empty usando la name proprietà di configurazione.

Non è possibile registrare due canali con lo stesso nome in un AppDomainoggetto . Per impostazione predefinita, il nome di un oggetto è "http" e il nome di un HttpChannelTcpChannel oggetto è "tcp". Pertanto, se si desidera registrare due canali dello stesso tipo, è necessario specificare un nome diverso per uno di essi tramite le proprietà di configurazione.

Per altre informazioni sulle proprietà di configurazione del canale, vedere HttpChannele <elemento del canale> (Modello).

RegisterChannel(IChannel, Boolean)

Registra un canale con i servizi dei canali.

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)

Parametri

chnl

IChannel

Canale da registrare.

ensureSecurity

Boolean

true garantisce che la sicurezza sia abilitata; in caso contrario, false. L'impostazione del valore su false non influisce sull'impostazione di sicurezza effettuata sul canale TCP o IPC.

Eccezioni

ArgumentNullException

Il valore del parametro chnl è null.

RemotingException

Il canale è già stato registrato.

SecurityException

Almeno uno dei chiamanti in posizione più elevata nello stack di chiamate non dispone delle autorizzazioni alla configurazione di canali e tipi remoti.

NotSupportedException

Non supportato per la classe HttpServerChannel. Se è necessario un canale HTTP sicuro, ospitare il servizio utilizzando Internet Information Services (IIS).

Commenti

Il RegisterChannel(IChannel, Boolean) metodo riceve l'interfaccia IChannel da un oggetto channel. Il canale ChannelName deve essere univoco o il canale deve essere anonimo. Un canale è anonimo se l'oggetto IChannel.ChannelName è impostato su null o Empty usando la name proprietà di configurazione.

Non è possibile registrare due canali con lo stesso nome in un AppDomainoggetto . Per impostazione predefinita, il nome di un oggetto è "http" e il nome di un HttpChannelTcpChannel oggetto è "tcp". Pertanto, se si desidera registrare due canali dello stesso tipo, è necessario specificare un nome diverso per uno di essi tramite le proprietà di configurazione.

Per altre informazioni sulle proprietà di configurazione del canale, vedere Proprietà di configurazione canale e<elemento del canale> (modello).

Se il parametro è impostato su true, il sistema di comunicazione remota determina se il ensureSecurity canale implementa ISecurableChannele, in caso affermativo, abilita la crittografia e le firme digitali. Viene generata un'eccezione se il canale non implementa ISecurableChannel.

Nota

L'impostazione ensureSecurity per true generare un RemotingException oggetto per il HttpServerChannel canale su tutte le piattaforme. È necessario ospitare il servizio in IIS se si vuole usare un canale HTTP sicuro.