Elemento <channel> (instancia)
Configura el canal que la aplicación utiliza para comunicar con objetos remotos. Se puede declarar y configurar asimismo un nuevo canal que no sea una plantilla de canal.
<configuration>
<system.runtime.remoting>
<application>
<channels>
<channel>
<!-- Either reference a channel template -->
<channel
ref="channelRef" displayName="name" port="port"/><!-- Or declare a particular channel instance --><channel type="ChannelType, ChannelAssembly" displayName="name" port="port" customChannelProperty="propertyValue"/>
Atributos opcionales
Atributo | Descripción |
---|---|
ref | Indica el id de la plantilla de canal que el cliente desea registrar para utilizarla. Si especifica un atributo ref, no es necesario especificar un atributo type. |
displayName | Lo utiliza la herramienta Configuración de .NET Framework para crear una lista de canales registrados por esta aplicación. El sistema .NET Remoting no utiliza este atributo. |
type | Indica el nombre de tipo completo del canal así como el nombre del ensamblado que contiene la implementación de canales. Esto incluye cualquier información de versión, referencia cultural y clave pública si el ensamblado contenedor está en la caché de ensamblados global. Se requiere este atributo si no se utiliza un atributo ref. |
port | Indica un atributo de puerto apropiado. Se puede especificar un atributo de puerto si, por ejemplo, se desea que el canal escuche en un puerto. Algunos canales, como TcpChannel, requieren la especificación de un puerto. Otros canales, como HttpChannel, tienen puertos predeterminados y, por consiguiente, no requieren este atributo. Si genera un cliente y especifica 0 (cero) como puerto, el sistema .NET Remoting elegirá un puerto apropiado. Si no se especifica ningún puerto para un canal de cliente, el cliente no podrá recibir las funciones de devolución de llamada desde el objeto remoto. |
<customChannelProperty> | Indica una propiedad de canal personalizado compatible. Se puede especificar un número ilimitado de propiedades de canal compatibles con los canales. Una propiedad de canal personalizado se especifica con un par atributo/valor. Por ejemplo:
|
Elementos secundarios
Elemento | Descripción |
---|---|
<serverProviders> | Contiene los proveedores de los receptores que se han de insertar en la cadena de llamadas de receptores de canal del servidor. Si se han especificado, éstos reemplazan completamente los valores predeterminados del canal. Puede producirse una sola vez en el elemento <channel>. |
<clientProviders> | Contiene los proveedores de los receptores que se han de insertar en la cadena de llamadas de receptores de canal del cliente. Si se han especificado, éstos reemplazan completamente los valores predeterminados del canal. Puede producirse una sola vez en el elemento <channel>. |
Comentarios
HttpChannel y TcpChannel que proporciona el sistema se especifican en el archivo de configuración del equipo. Sus atributos id son "http" y "tcp", respectivamente.
Ejemplo
En el siguiente archivo de configuración se declara la ubicación de un tipo remoto para una aplicación de cliente y se utiliza el elemento de instancia <channels> para especificar al sistema .NET Remoting que debe buscar un puerto apropiado desde el cual se pueda conectar con el objeto de servidor y que debe usar el HttpChannel predeterminado.
<configuration>
<system.runtime.remoting>
<application>
<client>
<wellknown
type="RemoteType, RemoteAssembly"
url="http://computername:8080/RemoteType.rem"
/>
</client>
<channels>
<channel
ref="http"
port="0"
/>
</channels>
</application>
</system.runtime.remoting>
</configuration>
Requisitos
Archivos de configuración: Archivo de configuración de la aplicación, archivo de configuración del equipo (Machine.config)
Vea también
Esquema de la configuración de la interacción remota | HttpChannel | HttpClientChannel | HttpServerChannel | TcpChannel | TcpClientChannel | TcpServerChannel