Élément <wellknown> (instance service)

Article
02/13/2011

Cette rubrique est spécifique à la technologie héritée assurant la compatibilité descendante avec des applications existantes et n'est pas recommandée en cas de nouveau développement. Les applications distribuées doivent maintenant être développées à l'aide de Windows Communication Foundation (WCF).

Contient les informations sur les objets connus activés par le serveur que l'application expose aux clients. Cet élément peut se trouver dans le fichier de configuration de l'ordinateur et dans le fichier de configuration de l'application.

Schema Hierarchy

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

Syntaxe

<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'URI (Uniform Resource Identifier) d'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 pour créer une liste d'objets activés par le serveur que publiera ce serveur inscrit. Le système .NET Framework Remoting n'utilise pas cet attribut.

Éléments enfants

Aucun.

Éléments parents

Élément	Description
application	Contient des informations sur les objets distants consommé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 le IHttpHandler de .NET Framework Remoting.

Exemple

Le fichier de configuration suivant déclare un type connu activé par le serveur, l'URI (Uniform Resource Identifier) d'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 de communication à distance

Concepts

Activation d'objets distants
Configuration d'applications distantes

Date de génération : 2010-02-13

Partager via