ILease Interfejs

Definicja

Definiuje obiekt dzierżawy okresu istnienia używany przez usługę czas trwania komunikacji zdalnej.Defines a lifetime lease object that is used by the remoting lifetime service.

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

Uwagi

Rozproszone wyrzucanie elementów bezużytecznych podczas usuwania aplikacji serwera.Distributed garbage collection controls when server applications can be deleted. Tradycyjna funkcja rozproszonego wyrzucania elementów bezużytecznych używa liczników odwołań i poleceń ping dla kontrolki.Traditionally, distributed garbage collection uses reference counts and pinging for control. Jest to dobre rozwiązanie w przypadku kilku klientów na obiekt, ale nie działa prawidłowo, gdy na każdym obiekcie są tysiące klientów.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. Usługa okres istnienia może przyjąć funkcję tradycyjnego rozproszonego modułu odzyskiwania pamięci i skalować ją w miarę wzrostu liczby klientów.The lifetime service can assume the function of a traditional distributed garbage collector, and scales well when the number of clients increases.

Usługa okres istnienia kojarzy dzierżawę z każdym zdalnym aktywowanym obiektem.The lifetime service associates a lease with each remotely activated object. Po wygaśnięciu dzierżawy obiekt zostanie usunięty.When the lease expires, the object is removed. Dzierżawa może określić, że obiekt ma nieskończony okres istnienia.A lease can specify that an object has an infinite lifetime.

Każdy z nich AppDomain zawiera Menedżera dzierżawy, który zarządza dzierżawami w domenie.Each AppDomain contains a lease manager that administers the leases in the domain. Menedżer dzierżawy okresowo analizuje dzierżawy dla wygaśnięcia czasu.The lease manager periodically examines the leases for time expiration. Jeśli Dzierżawa wygasła, może zostać anulowana przez usunięcie jej odwołania do dzierżawy lub odnowienie przez wywołanie co najmniej jednego sponsora dzierżawy.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.

Dzierżawa zawiera właściwości, które określają zasady i metody odnawiające czas dzierżawy.A lease contains properties that determine its policies, and methods that renew the lease time. Dzierżawa ujawnia ILease interfejs.The lease exposes the ILease interface.

Aby zapoznać się z przykładem, jak korzystać z ILease interfejsu, zobacz okresy istnienia.For an example showing how to use the ILease interface see Lifetimes.

Właściwości

CurrentLeaseTime

Pobiera ilość czasu pozostałego w dzierżawie.Gets the amount of time remaining on the lease.

CurrentState

Pobiera bieżącą LeaseState dzierżawę.Gets the current LeaseState of the lease.

InitialLeaseTime

Pobiera lub ustawia początkowy czas dzierżawy.Gets or sets the initial time for the lease.

RenewOnCallTime

Pobiera lub ustawia czas, przez który wywołanie zdalnego obiektu odnawia CurrentLeaseTime .Gets or sets the amount of time by which a call to the remote object renews the CurrentLeaseTime.

SponsorshipTimeout

Pobiera lub ustawia czas oczekiwania na zwrócenie przez sponsora w czasie odnawiania dzierżawy.Gets or sets the amount of time to wait for a sponsor to return with a lease renewal time.

Metody

Register(ISponsor)

Rejestruje sponsora dla dzierżawy bez odnawiania dzierżawy.Registers a sponsor for the lease without renewing the lease.

Register(ISponsor, TimeSpan)

Rejestruje sponsora dla dzierżawy i odnawia go przez określony TimeSpan .Registers a sponsor for the lease, and renews it by the specified TimeSpan.

Renew(TimeSpan)

Odnawia dzierżawę przez określony czas.Renews a lease for the specified time.

Unregister(ISponsor)

Usuwa sponsora z listy sponsorowania.Removes a sponsor from the sponsor list.

Dotyczy