Elemento <channel> (instancia)

Artículo
04/11/2008

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: `<channel ref="CustomChannel" port="61000" customProperty="PropertyValue" />`

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

Compartir a través de