<wellknown> Elemento (Instancia de cliente)

Este tema es específico de una tecnología heredada que se mantiene para la compatibilidad con versiones anteriores con aplicaciones existentes y no se recomienda para nuevo desarrollo. Las aplicaciones distribuidas se deberían desarrollar utilizando  Windows Communication Foundation (WCF).

Contiene información sobre los objetos (conocidos) activados en el servidor y que la aplicación desea consumir. Cuando un cliente utiliza un elemento <wellknown>, el elemento <client> primario no necesita un atributo url. Este elemento puede aparecer en un archivo de configuración del equipo o en un archivo de configuración de la aplicación.

Schema Hierarchy

<configuration>
  <system.runtime.remoting> (Elemento)
    <application> (Elemento)
      <client> (Elemento)
        <wellknown> Elemento (Instancia de cliente)

Sintaxis

<wellknown  
   url="url" 
   displayName="displayName" 
   type="type,assembly"
/>

Atributos y elementos

En las siguientes secciones se describen los atributos, elementos secundarios y elementos primarios.

Atributos

Atributo	Descripción
type	Atributo necesario. Especifica el nombre de tipo completo del objeto así como el nombre de ensamblado de la implementación de tipos en el cliente. Esto incluye la información de versión, referencia cultural y clave pública si el ensamblado contenedor está en la caché global de ensamblados.
url	Atributo necesario. Especifica la dirección URL completa del tipo activado en el servidor, incluido el Identificador de recursos uniforme (URI) del objeto.
displayName	Atributo opcional. Lo utiliza la herramienta de configuración de .NET Framework para crear una lista de objetos activados en el servidor y a los que puede llamar este cliente. El sistema de comunicación remota de .NET Framework no utiliza este atributo.

Elementos secundarios

Ninguno.

Elementos primarios

Elemento	Descripción
application	Contiene información sobre los objetos remotos que la aplicación consume y expone.
client	Contiene los objetos que la aplicación consume. Dado que se requiere el atributo url para los tipos activados en el cliente pero no para los tipos activados en el servidor, cada dirección URL única tiene su propio elemento cliente que contiene los tipos activados en el cliente publicados en dicha ubicación.
configuration	Elemento raíz de cada archivo de configuración que utilizan las aplicaciones Common Language Runtime y .NET Framework.
system.runtime.remoting	Contiene información sobre canales y objetos remotos.

Ejemplo

En el siguiente archivo de configuración se declara un tipo remoto (conocido) activado en el servidor para el consumo y se especifica que la aplicación cliente debe usar HttpChannel pero que debe permitir que el sistema remoto de .NET Framework encuentre un puerto apropiado en nombre del cliente.

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

Vea también

Referencia

Esquema de configuración de la comunicación remota

Conceptos

Activación de los objetos remotos

Fecha de compilación: 2010-02-13