ChannelServices.RegisterChannel Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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
Eccezioni
Il valore del parametro chnl
è null
.
Il canale è già stato registrato.
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).
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
Il valore del parametro chnl
è null
.
Il canale è già stato registrato.
Almeno uno dei chiamanti in posizione più elevata nello stack di chiamate non dispone delle autorizzazioni alla configurazione di canali e tipi remoti.
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.