ILease Schnittstelle

Definition

Definiert ein Lebensdauerlease-Objekt, das vom Remoting-Lebensdauerdienst verwendet wird.Defines a lifetime lease object that is used by the remoting lifetime service.

public interface class ILease
[System.Runtime.InteropServices.ComVisible(true)]
public interface ILease
type ILease = interface
Public Interface ILease
Attribute

Hinweise

Verteilte Garbage Collection steuert, wann Server Anwendungen gelöscht werden können.Distributed garbage collection controls when server applications can be deleted. In der Regel verwendet verteilte Garbage Collection Verweis Zählungen und Pings für das Steuerelement.Traditionally, distributed garbage collection uses reference counts and pinging for control. Dies funktioniert gut, wenn mehrere Clients pro Objekt vorhanden sind, aber nicht gut funktioniert, wenn Tausende von Clients pro Objekt vorhanden sind.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. Der Lebensdauer Dienst kann die Funktion eines herkömmlichen verteilten Garbage Collector annehmen und gut skaliert werden, wenn sich die Anzahl der Clients erhöht.The lifetime service can assume the function of a traditional distributed garbage collector, and scales well when the number of clients increases.

Der Lebensdauer Dienst ordnet jedem Remote aktivierten Objekt eine Lease zu.The lifetime service associates a lease with each remotely activated object. Wenn die Lease abläuft, wird das-Objekt entfernt.When the lease expires, the object is removed. Eine Lease kann angeben, dass ein Objekt über eine unbegrenzte Lebensdauer verfügt.A lease can specify that an object has an infinite lifetime.

Jeder AppDomain enthält einen Lease-Manager, der die Leases in der Domäne verwaltet.Each AppDomain contains a lease manager that administers the leases in the domain. Der Lease-Manager überprüft die Leases regelmäßig auf den Ablauf des Zeitraums.The lease manager periodically examines the leases for time expiration. Wenn eine Lease abgelaufen ist, kann Sie entweder abgebrochen werden, indem der Verweis auf die Lease entfernt oder durch Aufrufen eines oder mehrerer der Sponsoren der Lease erneuert wird.If a lease has expired, it can either be canceled by removing its reference to the lease, or renewed by invoking one or more of the lease's sponsors.

Eine Lease enthält Eigenschaften, die Ihre Richtlinien bestimmen, und Methoden, mit denen die leasereitzeit erneuert wird.A lease contains properties that determine its policies, and methods that renew the lease time. Die Lease macht die ILease -Schnittstelle verfügbar.The lease exposes the ILease interface.

Ein Beispiel für die Verwendung der ILease -Schnittstelle finden Sie unter LebensDauer.For an example showing how to use the ILease interface see Lifetimes.

Eigenschaften

CurrentLeaseTime

Ruft die für den Lease verbleibende Zeitspanne ab.Gets the amount of time remaining on the lease.

CurrentState

Ruft den aktuellen LeaseState des Lease ab.Gets the current LeaseState of the lease.

InitialLeaseTime

Ruft die Anfangsdauer für den Lease ab oder legt diese fest.Gets or sets the initial time for the lease.

RenewOnCallTime

Ruft die Zeitspanne ab, um die ein Aufruf des Remoteobjekts die CurrentLeaseTime erneuert, oder legt diese fest.Gets or sets the amount of time by which a call to the remote object renews the CurrentLeaseTime.

SponsorshipTimeout

Ruft die Zeitspanne ab, die gewartet werden soll, bis der Sponsor die Erneuerungszeit für den Lease zurückgibt, oder legt diese fest.Gets or sets the amount of time to wait for a sponsor to return with a lease renewal time.

Methoden

Register(ISponsor)

Registriert einen Sponsor für den Lease, ohne den Lease zu erneuern.Registers a sponsor for the lease without renewing the lease.

Register(ISponsor, TimeSpan)

Registriert einen Sponsor für den Lease und erneuert ihn um die angegebene TimeSpan.Registers a sponsor for the lease, and renews it by the specified TimeSpan.

Renew(TimeSpan)

Erneuert einen Lease für die angegebene Zeit.Renews a lease for the specified time.

Unregister(ISponsor)

Entfernt einen Sponsor aus der Sponsorenliste.Removes a sponsor from the sponsor list.

Gilt für: