Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

LifetimeServices Class

Controls the.NET remoting lifetime services.


Namespace:  System.Runtime.Remoting.Lifetime
Assembly:  mscorlib (in mscorlib.dll)

<ComVisibleAttribute(True)> _
Public NotInheritable Class LifetimeServices

The LifetimeServices type exposes the following members.

Public methodLifetimeServices Obsolete. Creates an instance of LifetimeServices.

Public propertyStatic memberLeaseManagerPollTimeGets or sets the time interval between each activation of the lease manager to clean up expired leases.
Public propertyStatic memberLeaseTimeGets or sets the initial lease time span for an AppDomain.
Public propertyStatic memberRenewOnCallTimeGets or sets the amount of time by which the lease is extended every time a call comes in on the server object.
Public propertyStatic memberSponsorshipTimeoutGets or sets the amount of time the lease manager waits for a sponsor to return with a lease renewal time.

Public methodEquals(Object)Determines whether the specified object is equal to the current object. (Inherited from Object.)
Public methodGetHashCodeServes as the default hash function. (Inherited from Object.)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Public methodToStringReturns a string that represents the current object. (Inherited from Object.)

Distributed garbage collection is responsible for controlling the lifetimes of server applications, and for deleting them when their lifetimes have expired. Traditionally, distributed garbage collection uses reference counts and pinging for control. This works well when there are a few clients per object, but does not work well when there are thousands of clients per each object. The lifetime service can assume the function of a traditional distributed garbage collector, and scales well when the number of clients increases.

The lifetime service associates a lease with each remotely activated object. When the lease expires, the object is removed.


This class makes a link demand. A SecurityException is thrown if the immediate caller does not have infrastructure permission. See Link Demands for more information.

Imports System
Imports System.Runtime.Remoting
Imports System.Runtime.Remoting.Channels
Imports System.Runtime.Remoting.Channels.Http
Imports System.Runtime.Remoting.Lifetime
Imports System.Security.Permissions

Public Class Server

   Public Shared Sub Main()
      Dim myServer As New Server()
   End Sub 'Main

<SecurityPermission(SecurityAction.Demand, Flags:=SecurityPermissionFlag.Infrastructure)> _ 
   Public Sub Run()
      LifetimeServices.LeaseTime = TimeSpan.FromSeconds(5)
      LifetimeServices.LeaseManagerPollTime = TimeSpan.FromSeconds(3)
      LifetimeServices.RenewOnCallTime = TimeSpan.FromSeconds(2)
      LifetimeServices.SponsorshipTimeout = TimeSpan.FromSeconds(1)

      ChannelServices.RegisterChannel(New HttpChannel(8080), True)

      Console.WriteLine("The server is listening. Press Enter to exit....")

   End Sub 'Run

End Class 'Server

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
© 2015 Microsoft