<wellknown> Elemento (Instancia de servicio)

Artículo
02/17/2011

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 que la aplicación expone a los clientes. 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)
      <service> (Elemento)
        <wellknown> Elemento (Instancia de servicio)

Sintaxis

<wellknown  
   mode="Singleton|SingleCall"
   displayName="name"
   type="type,assembly" 
      objectUri="objectUri" 
/>

Atributos y elementos

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

Atributos

Atributo	Descripción
mode	Atributo necesario. Indica si el objeto es un objeto Singleton o SingleCall. Se ha de seleccionar una opción. Para obtener más información, vea Activación.
objectUrl	Atributo necesario. Especifica el extremo del Identificador de recursos uniforme (URI) del objeto.
type	Atributo necesario. Especifica el nombre de tipo completo del objeto así como el nombre de ensamblado de la implementación de tipos. 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.
displayName	Atributo opcional. Lo utiliza la herramienta de configuración de .NET Framework para crear una lista de objetos activados en el servidor y para cuya publicación está registrado este servidor. 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.
configuration	Elemento raíz de cada archivo de configuración que utilizan las aplicaciones Common Language Runtime y .NET Framework.
service	Contiene los objetos que la aplicación expone a otros dominios de aplicación o contextos.
system.runtime.remoting	Contiene información sobre canales y objetos remotos.

Notas

Cuando un objeto está hospedado en Internet Information Services (IIS), la extensión objectUri debe ser .soap o .rem, de modo que la solicitud se enrute al IHttpHandler remoto de .NET Framework.

Ejemplo

En el siguiente archivo de configuración se declara un tipo (conocido) activado en el servidor, el URI del objeto donde se puede encontrar y el WellKnownObjectMode que controla la activación de las instancias.

<configuration>
   <system.runtime.remoting>
      <application>
         <service>
            <wellknown 
               type="ServerActivatedType, RemoteAssembly" 
               objectUri="ServerType.rem" 
               mode="Singleton" 
            />
         </service>
      </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
Configuración de aplicaciones remotas

Fecha de compilación: 2010-02-13

Compartir a través de