ChannelServices.RegisterChannel Método

Definición

Espacio de nombres:

System.Runtime.Remoting.Channels

Ensamblado:

mscorlib.dll

Sobrecargas

RegisterChannel(IChannel)	Obsoletos. Registra un canal con los servicios de canal. RegisterChannel(IChannel) está obsoleto. Use RegisterChannel(IChannel, Boolean) en su lugar.
RegisterChannel(IChannel, Boolean)	Registra un canal con los servicios de canal.

RegisterChannel(IChannel)

Precaución

Use System.Runtime.Remoting.ChannelServices.RegisterChannel(IChannel chnl, bool ensureSecurity) instead.

Registra un canal con los servicios de canal. RegisterChannel(IChannel) está obsoleto. Use RegisterChannel(IChannel, Boolean) en su lugar.

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

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

Parámetros

chnl

IChannel

Canal que se va a registrar.

Atributos

ObsoleteAttribute

Excepciones

ArgumentNullException

El parámetro chnl es null.

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 de comunicación remota.

Ejemplos

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

Comentarios

Nota

RegisterChannel(IChannel) está obsoleto. Use RegisterChannel(IChannel, Boolean) en su lugar.

El RegisterChannel método toma la IChannel interfaz de un objeto de canal. El valor del ChannelName canal debe ser único o el canal debe ser anónimo. Un canal es anónimo si IChannel.ChannelName se establece null en o Empty mediante la propiedad de name configuración .

No se pueden registrar dos canales con el mismo nombre en .AppDomain De forma predeterminada, el nombre de es HttpChannel "http" y el nombre de un TcpChannel es "tcp". Por lo tanto, si desea registrar dos canales del mismo tipo, 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 las propiedades de configuración del canal, vea HttpChannelElemento de canal> (plantilla) y< .

RegisterChannel(IChannel, Boolean)

Registra un canal con los servicios 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 -> unit

Public Shared Sub RegisterChannel (chnl As IChannel, ensureSecurity As Boolean)

Parámetros

chnl

IChannel

Canal que se va a registrar.

ensureSecurity

Boolean

El valor true garantiza que la seguridad está habilitada; en caso contrario, es false. Al establecer el valor en false, no se realiza la configuración de seguridad en el canal TCP o IPC.

Excepciones

ArgumentNullException

El parámetro chnl es null.

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 de comunicación remota.

NotSupportedException

No se admite para HttpServerChannel. Hospede el servicio mediante IIS (Internet Information Services) si requiere un canal HTTP seguro.

Comentarios

El RegisterChannel(IChannel, Boolean) método recibe la IChannel interfaz de un objeto de canal. El valor del ChannelName canal debe ser único o el canal debe ser anónimo. Un canal es anónimo si IChannel.ChannelName se establece null en o Empty mediante la propiedad de name configuración .

No se pueden registrar dos canales con el mismo nombre en .AppDomain De forma predeterminada, el nombre de es HttpChannel "http" y el nombre de un TcpChannel es "tcp". Por lo tanto, si desea registrar dos canales del mismo tipo, 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 las propiedades de configuración del canal, vea Propiedades de configuración de canal y formateador y <elemento de canal> (plantilla).

Si el ensureSecurity parámetro se establece trueen , el sistema de comunicación remota determina si el canal implementa ISecurableChannely, si es así, habilita el cifrado y las firmas digitales. Se produce una excepción si el canal no implementa ISecurableChannel.

Nota

Al establecer ensureSecurity en true se inicia un RemotingException para el HttpServerChannel canal en todas las plataformas. Debe hospedar el servicio en IIS si desea usar un canal HTTP seguro.