ChannelServices.RegisterChannel Metodo

  • Riferimento

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

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 canale. Il canale ChannelName deve essere univoco oppure il canale deve essere anonimo. Un canale è anonimo se è IChannel.ChannelName impostato su null o Empty tramite la name proprietà di configurazione.

Non è possibile registrare due canali con lo stesso nome in un oggetto AppDomain. Per impostazione predefinita, il nome di un HttpChannel oggetto è "http" e il nome di un TcpChannel 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 HttpChannelElemento canale> (modello) e< .

Si applica a

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 canale. Il canale ChannelName deve essere univoco oppure il canale deve essere anonimo. Un canale è anonimo se è IChannel.ChannelName impostato su null o Empty tramite la name proprietà di configurazione.

Non è possibile registrare due canali con lo stesso nome in un oggetto AppDomain. Per impostazione predefinita, il nome di un HttpChannel oggetto è "http" e il nome di un TcpChannel 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 Channel and Formatter Configuration Properties and <Channel> Element (Template).

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

Nota

L'impostazione ensureSecurity di per generare true un'eccezione RemotingException per il HttpServerChannel canale su tutte le piattaforme. Se si vuole usare un canale HTTP sicuro, è necessario ospitare il servizio in IIS.

Si applica a