Élément <lifetime>

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 la durée de vie de tous les objets activés par le client et traités par l'application. Il est possible de définir un contrôle spécifique de la durée de vie de chaque objet en substituant System.MarshalByRefObject.InitializeLifetimeService sur votre type distant. 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 <lifetime>

Syntaxe

<lifetime  
   leaseTime="leasetime"
   sponsorshipTimeout="sponsorshipTimeOut"
   renewOnCallTime="renewOnCallTime"
      leaseManagerPollTime="pollTime" 
/>

Attributs et éléments

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

Attributs

Attribut	Description
leaseTime	Attribut facultatif. Spécifie la durée du bail pour l'application. La valeur par défaut de leaseTime est 5 minutes.
sponsorshipTimeout	Attribut facultatif. Spécifie la durée pendant laquelle le gestionnaire de bail attend une réponse du commanditaire une fois que l'expiration du bail a été notifiée. Si le commanditaire ne répond pas pendant le délai spécifié, le « garbage collector » supprime l'objet distant. La valeur par défaut de sponsorshipTimeout est 2 minutes.
renewOnCallTime	Attribut facultatif. Spécifie le nombre de minutes dont la durée de bail est prolongée lors de chaque appel de fonction sur l'objet. La valeur par défaut de renewOnCallTime est 2 minutes.
leaseManagerPollTime	Attribut facultatif. Spécifie la durée pendant laquelle le gestionnaire de bail est mis en veille après la vérification des baux expirés. La valeur par défaut de leaseManagerPollTime est 10 secondes.

É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.
system.runtime.remoting	Contient des informations sur les canaux et les objets distants.

Notes

L'élément <lifetime> possède quatre attributs facultatifs. Les valeurs valides pour chaque attribut sont un nombre décimal et une unité de temps. Les unités de temps valides sont les suivantes : D pour les jours, H pour les heures, M pour les minutes, S pour les secondes et MS pour les millisecondes. Si aucune unité n'est spécifiée, l'unité de temps par défaut est la seconde. Par exemple, « 10 » est interprété comme « 10 S ».

Exemple

L'exemple suivant attribue à tous les objets activés par le client une durée de bail de 5 minutes, un délai d'obtention d'un commanditaire de 2 minutes, 2 minutes supplémentaires à chaque appel à une méthode et un délai de sondage du gestionnaire de bail de 10 secondes.

<lifetime 
   leaseTime="5M" 
   sponsorshipTimeOut="2M" 
   renewOnCallTime="2M" 
   leaseManagerPollTime="10S"
/>

Voir aussi

Référence

Schéma des paramètres de communication à distance
System.MarshalByRefObject.InitializeLifetimeService

Concepts

Activation d'objets distants

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

Partager via