ChannelServices.RegisterChannel Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| Nome | Description |
|---|---|
| RegisterChannel(IChannel) |
Obsoleto.
Registra um canal com os serviços de canal. RegisterChannel(IChannel) é obsoleto. Use RegisterChannel(IChannel, Boolean) em seu lugar. |
| RegisterChannel(IChannel, Boolean) |
Registra um canal com os serviços de canal. |
RegisterChannel(IChannel)
Cuidado
Use System.Runtime.Remoting.ChannelServices.RegisterChannel(IChannel chnl, bool ensureSecurity) instead.
Registra um canal com os serviços de canal. RegisterChannel(IChannel) é obsoleto. Use RegisterChannel(IChannel, Boolean) em seu lugar.
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 a ser registrado.
- Atributos
Exceções
O chnl parâmetro é null.
O canal já foi registrado.
Pelo menos um dos chamadores mais altos na caixa de chamadas não tem permissão para configurar tipos e canais de comunicação remota.
Comentários
Observação
RegisterChannel(IChannel) é obsoleto. Use RegisterChannel(IChannel, Boolean) em seu lugar.
O RegisterChannel método usa a IChannel interface de um objeto de canal. O canal ChannelName deve ser exclusivo ou o canal deve ser anônimo. Um canal será anônimo se estiver IChannel.ChannelName definido como ou nullEmpty usando a name propriedade de configuração.
Não é possível registrar dois canais com o mesmo nome em um AppDomain. Por padrão, o nome de um HttpChannel é "http" e o nome de um TcpChannel é "tcp". Portanto, se você quiser registrar dois canais do mesmo tipo, deverá especificar um nome diferente para um deles por meio de propriedades de configuração.
Para obter mais informações sobre as propriedades de configuração de canal, consulte HttpChannel.
Aplica-se a
RegisterChannel(IChannel, Boolean)
Registra um canal com os 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 a ser registrado.
- ensureSecurity
- Boolean
true garante que a segurança esteja habilitada; caso contrário false. Definir o valor para false não afetar a configuração de segurança no canal TCP ou IPC.
Exceções
O chnl parâmetro é null.
O canal já foi registrado.
Pelo menos um dos chamadores mais altos na pilha de chamadas não tem permissão para configurar tipos e canais de comunicação remota.
Não há suporte para HttpServerChannel. Hospede o serviço usando Serviços de Informações da Internet (IIS) se você precisar de um canal HTTP seguro.
Comentários
O RegisterChannel(IChannel, Boolean) método recebe a IChannel interface de um objeto de canal. O canal ChannelName deve ser exclusivo ou o canal deve ser anônimo. Um canal será anônimo se estiver IChannel.ChannelName definido como ou nullEmpty usando a name propriedade de configuração.
Não é possível registrar dois canais com o mesmo nome em um AppDomain. Por padrão, o nome de um HttpChannel é "http" e o nome de um TcpChannel é "tcp". Portanto, se você quiser registrar dois canais do mesmo tipo, deverá especificar um nome diferente para um deles por meio de propriedades de configuração.
Se o ensureSecurity parâmetro for definido como true, o sistema de comunicação remota determinará se o canal implementa ISecurableChannele, se for o caso, habilitará a criptografia e as assinaturas digitais. Uma exceção será gerada se o canal não implementar ISecurableChannel.
Observação
A configuração ensureSecurity para true lançar um RemotingException para o HttpServerChannel canal em todas as plataformas. Você deve hospedar seu serviço no IIS se quiser usar um canal http seguro.
