<wellknown>, élément (instance service)

Contient les informations sur les objets connus activés par le serveur que l'application expose aux clients.

<configuration>, élément
  <system.runtime.remoting>, élément
    <application>, élément
      <service>, élément
        <wellknown>, élément (instance service)

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

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Attribut	Description
mode	Attribut requis. Indique si l'objet est un objet Singleton ou SingleCall. Une seule option doit être sélectionnée. Pour plus d'informations, consultez Activation.
objectUrl	Attribut requis. Spécifie le point de terminaison de l'identificateur URI de l'objet.
type	Attribut requis. Spécifie le nom complet du type de l'objet et le nom d'assembly de l'implémentation du type. Cela inclut les informations de version, de culture et de clé publique si l'assembly conteneur se trouve dans le Global Assembly Cache.
displayName	Attribut facultatif. Utilisé par l'outil .NET Framework Configuration Tool pour créer une liste d'objets activés par le serveur que ce serveur est inscrit pour publier. Le système distant .NET Framework n'utilise pas cet attribut.

Éléments enfants

Aucun(e).

Éléments parents

Élément	Description
application	Contient des informations sur les objets distants utilisés et exposés par l'application.
configuration	Élément racine de chaque fichier de configuration utilisé par le Common Language Runtime et les applications .NET Framework.
service	Contient les objets que l'application expose aux autres contextes ou domaines d'application.
system.runtime.remoting	Contient des informations sur les canaux et les objets distants.

Notes

Lorsqu'un objet est hébergé dans les services IIS (Internet Information Services), l'extension d'objectUri doit être .soap ou .rem pour que la demande soit acheminée vers l'IHttpHandler distant du .NET Framework.

Exemple

Le fichier de configuration suivant déclare un type connu activé par le serveur, l'identificateur URI (Uniform Resource Identifier) de l'objet auquel il doit se trouver et le WellKnownObjectMode qui contrôle l'activation des instances.

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

Voir aussi

Référence

Schéma des paramètres d'accès distant

Concepts

Activation des objets distants
Configuration d'applications distantes