<wellknown> Element (Service Instance)

Article
10/23/2006

Contains information about server-activated (well-known) objects the application exposes to clients.

<configuration>
   <system.runtime.remoting>
      <application>
         <service>
**            <wellknown>**

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

Optional Attributes

Attribute	Description
displayName	Used by the .NET Framework Configuration Tool to create a list of server-activated objects this server is registered to publish. The .NET Remoting system does not use this attribute.

Required Attributes

Attribute	Description
mode	Indicates whether the object is a Singleton or SingleCall object. One option must be selected. For details, see Activation.
type	Specifies the full type name of the object and the assembly name of the type implementation. This includes version, culture, and public key information if the containing assembly is in the global assembly cache.
objectUri	Specifies the endpoint of the object's Uniform Resource Identifier (URI).

Remarks

When an object is hosted in Internet Information Services (IIS), the objectUri extension must be .soap or .rem, so that the request is routed to the .NET Remoting IHttpHandler.

Example

The following configuration file declares a server-activated (well-known) type, the object URI at which it is to be found, and the WellKnownObjectMode that controls activation of instances.

<configuration>
   <system.runtime.remoting>
      <application>
         <service>
            <wellknown 
               type="ServerActivatedType, RemoteAssembly" 
               objectUri="ServerType.rem" 
               mode="Singleton" 
            />
         </service>
      </application>
   </system.runtime.remoting>
</configuration>

Requirements

Configuration Files: Application configuration file, machine configuration file (Machine.config)