ChannelServices.RegisterChannel Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Sobrecargas
| Name | Description |
|---|---|
| RegisterChannel(IChannel) |
Obsoleto.
Regista um canal junto dos serviços de canal. RegisterChannel(IChannel) está obsoleto. Por favor, use RegisterChannel(IChannel, Boolean) em vez disso. |
| RegisterChannel(IChannel, Boolean) |
Regista um canal junto dos serviços de canal. |
RegisterChannel(IChannel)
Atenção
Use System.Runtime.Remoting.ChannelServices.RegisterChannel(IChannel chnl, bool ensureSecurity) instead.
Regista um canal junto dos serviços de canal. RegisterChannel(IChannel) está obsoleto. Por favor, use RegisterChannel(IChannel, Boolean) em vez disso.
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 -> unitPublic Shared Sub RegisterChannel (chnl As IChannel)Parâmetros
- chnl
- IChannel
O canal para se registar.
- Atributos
Exceções
O chnl parâmetro é null.
O canal já foi registado.
Pelo menos um dos chamadores mais acima na pilha de chamadas não tem permissão para configurar tipos e canais de remoto.
Observações
Note
RegisterChannel(IChannel) está obsoleto. Por favor, use RegisterChannel(IChannel, Boolean) em vez disso.
O RegisterChannel método absorve a IChannel interface de um objeto de canal. Os canais ChannelName devem ser únicos, ou o canal deve ser anónimo. Um canal é anónimo se o IChannel.ChannelName for definido como ou nullEmpty usando a name propriedade de configuração.
Não pode registar dois canais com o mesmo nome num AppDomain. Por defeito, o nome de um HttpChannel é "http" e o nome de um TcpChannel é "tcp." Portanto, se quiser registar dois canais do mesmo tipo, deve especificar um nome diferente para um deles através das propriedades de configuração.
Para mais informações sobre as propriedades de configuração do canal, veja HttpChannel, e <Elemento do canal> (Modelo).
Aplica-se a
RegisterChannel(IChannel, Boolean)
Regista um canal junto dos serviços de canal.
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 -> unitPublic Shared Sub RegisterChannel (chnl As IChannel, ensureSecurity As Boolean)Parâmetros
- chnl
- IChannel
O canal para se registar.
- ensureSecurity
- Boolean
true garante que a segurança está ativada; caso contrário false. Definir o valor para false não afeta a definição de segurança no canal TCP ou IPC.
Exceções
O chnl parâmetro é null.
O canal já foi registado.
Pelo menos um dos chamadores mais acima na pilha de chamadas não tem permissão para configurar tipos e canais remotos.
Não suportado para HttpServerChannel. Aloje o serviço usando o Serviços de Informação Internet (IIS) se precisar de um canal HTTP seguro.
Observações
O RegisterChannel(IChannel, Boolean) método recebe a IChannel interface de um objeto de canal. Os canais ChannelName devem ser únicos, ou o canal deve ser anónimo. Um canal é anónimo se o IChannel.ChannelName for definido como ou nullEmpty usando a name propriedade de configuração.
Não pode registar dois canais com o mesmo nome num AppDomain. Por defeito, o nome de a HttpChannel é "http" e o nome de a TcpChannel é "tcp". Portanto, se quiser registar dois canais do mesmo tipo, deve especificar um nome diferente para um deles através das propriedades de configuração.
Para mais informações sobre as propriedades de configuração do canal, consulte Propriedades de Configuração de Canal e Formatador e <Elemento de Canal> (Modelo).
Se o ensureSecurity parâmetro for definido para true, o sistema remoto determina se o canal implementa ISecurableChannel, e, em caso afirmativo, permite encriptação e assinaturas digitais. É lançada uma exceção se o canal não implementar ISecurableChannel.
Note
A definir ensureSecuritytrue para lançar um RemotingException para o HttpServerChannel canal em todas as plataformas. Tens de alojar o teu serviço no IIS se quiseres usar um canal http seguro.
