Export (0) Print
Expand All

<wellknown> Element (Service Instance)

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)

See Also

Remoting Settings Schema | Activation | Configuration

Show:
© 2014 Microsoft