<wellknown> Element (Client Instance) 

  • Article

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.

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

Attributes and Elements

The following sections describe attributes, child elements, and parent elements.

Attributes

Attribute Description

type

Required attribute.

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.

url

Required attribute.

Specifies the full URL of the server-activated type, including the object Uniform Resource Identifier (URI).

displayName

Optional attribute.

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

Child Elements

None.

Parent Elements

Element Description

application

Contains information about remote objects the application consumes and exposes.

client

Contains objects the application consumes. Because the url attribute is required for client-activated types, but not for server-activated types, each unique URL will have its own client element containing the client-activated types published at that location.

configuration

The root element in every configuration file used by the common language runtime and .NET Framework applications.

system.runtime.remoting

Contains information about remote objects and channels.

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

See Also

Reference

Remoting Settings Schema

Concepts

Activation of Remote Objects