Nota: este método es nuevo en la versión 2.0 de .NET Framework.
Registra un canal con los servicios de canal.
Espacio de nombres: System.Runtime.Remoting.Channels
Ensamblado: mscorlib (en mscorlib.dll)
Visual Basic (Declaración)
Public Shared Sub RegisterChannel ( _
chnl As IChannel, _
ensureSecurity As Boolean _
)
Dim chnl As IChannel
Dim ensureSecurity As Boolean
ChannelServices.RegisterChannel(chnl, ensureSecurity)
public static void RegisterChannel (
IChannel chnl,
bool ensureSecurity
)
public:
static void RegisterChannel (
IChannel^ chnl,
bool ensureSecurity
)
public static void RegisterChannel (
IChannel chnl,
boolean ensureSecurity
)
public static function RegisterChannel (
chnl : IChannel,
ensureSecurity : boolean
)
Parámetros
- chnl
Canal que se va a registrar.
- ensureSecurity
El valor true garantiza que la seguridad está habilitada; en caso contrario, es false. Si se establece el valor en false, no se anulará la configuración de seguridad establecida en el canal TCP o IPC.
| Tipo de excepción | Condición |
|---|
ArgumentNullException | El parámetro chnl es referencia de objeto null (Nothing en Visual Basic). |
RemotingException | Ya se registró el canal. |
SecurityException | Al menos uno de los llamadores situados en la parte superior de la pila de llamadas no tiene permiso para configurar los tipos y canales remotos. |
NotSupportedException | No se admite en Windows 98 para TcpServerChannel ni en ninguna de las plataformas para HttpServerChannel. Aloje el servicio mediante IIS (Servicios de Internet Information Server) si requiere un canal HTTP seguro. |
El método RegisterChannel(IChannel,Boolean) toma la interfaz IChannel de un objeto de canal. La propiedad ChannelName del canal debe ser única o el canal debe ser anónimo. Un canal es anónimo si IChannel.ChannelName se establece en referencia de objeto null (Nothing en Visual Basic) o en Empty utilizando la propiedad de configuración name.
No se pueden registrar dos canales con el mismo nombre en un AppDomain. De forma predeterminada, el nombre de un HttpChannel es "http" y el nombre de un TcpChannel es "tcp". Por tanto, si se desea registrar dos canales del mismo tipo, se debe especificar un nombre diferente para uno de ellos a través de las propiedades de configuración.
Para obtener más información sobre propiedades de configuración de canales, vea Propiedades de configuración del canal y del formateador y <channel> (Elemento, Plantilla).
Nota |
|---|
| Si se establece esureSecurity en true se inicia una excepción de TcpServerChannel en Windows 98 (el canal tcp seguro no es compatible con Windows 9x); se inicia una excepción de HttpServerChannel en todas las plataformas (los usuarios deben alojar el servicio en IIS si desean un canal http protegido). |
Seguridad de .NET Framework
Windows 98, Windows 2000 SP4, Windows Millennium, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter Edition
.NET Framework no admite todas las versiones de cada plataforma. Para obtener una lista de las versiones admitidas, vea Requisitos del sistema.
.NET Framework
Compatible con: 2.0