<wellknown> Element (Client Instance)

Contains information about server-activated (well-known) objects the application wants to consume. When a client uses a <wellknown> element, the parent <client> element does not need a url attribute.

<configuration>
   <system.runtime.remoting>
      <application>
         <client>
            <wellknown>

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

Optional Attributes

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

Required Attributes

Attribute Description
url Specifies the full URL of the server-activated type, including the object Uniform Resource Identifier (URI).
type Specifies the full type name of the object and the assembly name of the type implementation on the client. This includes version, culture, and public key information if the containing assembly is in the global assembly cache.

Example

The following configuration file declares a server-activated (well-known) remote type for consumption and specifies that the client application should use the HttpChannel but allow the .NET Remoting system to find an appropriate port on the client's behalf.

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

Requirements

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

See Also

Remoting Settings Schema | Activation