Élément <wellknown> (instance client)

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 des informations sur les objets connus activés par le serveur que l'application compte utiliser. Lorsqu'un client utilise un élément <wellknown>, l'élément parent <client> ne nécessite pas d'attribut url. 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 <client>
        Élément <wellknown> (instance client)

Syntaxe

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

Attributs et éléments

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

Attributs

Attribut	Description
type	Attribut requis. Spécifie le nom complet du type de l'objet et le nom de l'assembly qui contient l'implémentation du type sur le client. Cela inclut les informations de version, de culture et de clé publique si l'assembly conteneur se trouve dans le Global Assembly Cache.
url	Attribut requis. Spécifie l'URL complète du type activé par le serveur, y compris l'URI (Uniform Resource Identifier ) d'objet.
displayName	Attribut facultatif. Utilisé par l'outil .NET Framework Configuration pour créer une liste d'objets activés par le serveur que ce client est inscrit pour appeler. Le système .NET Framework Remoting n'utilise pas cet attribut.

type

Attribut requis.

Spécifie le nom complet du type de l'objet et le nom de l'assembly qui contient l'implémentation du type sur le client. Cela inclut les informations de version, de culture et de clé publique si l'assembly conteneur se trouve dans le Global Assembly Cache.

url

Attribut requis.

Spécifie l'URL complète du type activé par le serveur, y compris l'URI (Uniform Resource Identifier ) d'objet.

displayName

Attribut facultatif.

Utilisé par l'outil .NET Framework Configuration pour créer une liste d'objets activés par le serveur que ce client est inscrit pour appeler. 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 utilisés et exposés par l'application.
client	Contient les objets utilisés par l'application. Étant donné que l'attribut url est requis pour des types activés par le client, mais pas pour des types activés par le serveur, chaque URL unique aura son propre élément client contenant les types activés par le client, publiés à cet emplacement.
configuration	Élément racine de chaque fichier de configuration utilisé par le common language runtime et les applications .NET Framework.
system.runtime.remoting	Contient des informations sur les canaux et les objets distants.

Exemple

Le fichier de configuration suivant déclare le type distant connu activé par le serveur à utiliser et spécifie que l'application cliente doit utiliser le HttpChannel tout en permettant au système .NET Framework Remoting de rechercher un port approprié au nom du client.

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

Voir aussi

Référence

Schéma des paramètres de communication à distance

Concepts

Activation d'objets distants

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

Partager via