ILease ILease ILease ILease Interface

Definición

Define un objeto de concesión de período de duración que utiliza el servicio de duración de comunicación remota.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
Atributos

Comentarios

Los controles de recolección de elementos no utilizados distribuida cuando se pueden eliminar aplicaciones de servidor.Distributed garbage collection controls when server applications can be deleted. Tradicionalmente, la recolección de elementos no utilizados distribuida utiliza recuentos de referencias y hace ping para el control.Traditionally, distributed garbage collection uses reference counts and pinging for control. Esto funciona bien cuando hay algunos clientes por objeto, pero no funciona bien cuando hay miles de clientes por cada objeto.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. El servicio de duración puede asumir la función de un recolector de elementos no utilizados tradicional distribuido y se escala bien cuando aumenta el número de clientes.The lifetime service can assume the function of a traditional distributed garbage collector, and scales well when the number of clients increases.

El servicio de duración asocia una concesión a cada objeto activado de forma remota.The lifetime service associates a lease with each remotely activated object. Cuando expira la concesión, se quita el objeto.When the lease expires, the object is removed. Una concesión puede especificar que un objeto tiene una duración infinita.A lease can specify that an object has an infinite lifetime.

Cada AppDomain contiene un administrador de concesiones que administra las concesiones del dominio.Each AppDomain contains a lease manager that administers the leases in the domain. El administrador de concesiones examina periódicamente las concesiones para la expiración del tiempo.The lease manager periodically examines the leases for time expiration. Si una concesión ha expirado, se puede cancelar quitando su referencia a la concesión o reparada mediante la invocación de uno o más de los patrocinadores de la concesión.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.

Una concesión contiene propiedades que determinan sus directivas y métodos que renuevan el tiempo de concesión.A lease contains properties that determine its policies, and methods that renew the lease time. La concesión expone la ILease interfaz.The lease exposes the ILease interface.

Para ver un ejemplo en el que se ILease muestra cómo usar la interfaz, vea vigencias.For an example showing how to use the ILease interface see Lifetimes.

Propiedades

CurrentLeaseTime CurrentLeaseTime CurrentLeaseTime CurrentLeaseTime

Obtiene la cantidad de tiempo restante de la concesión.Gets the amount of time remaining on the lease.

CurrentState CurrentState CurrentState CurrentState

Obtiene el LeaseState actual de la concesión.Gets the current LeaseState of the lease.

InitialLeaseTime InitialLeaseTime InitialLeaseTime InitialLeaseTime

Obtiene o establece la hora inicial de la concesión.Gets or sets the initial time for the lease.

RenewOnCallTime RenewOnCallTime RenewOnCallTime RenewOnCallTime

Obtiene o establece el tiempo en que se renueva la propiedad CurrentLeaseTime en una llamada a objeto remoto.Gets or sets the amount of time by which a call to the remote object renews the CurrentLeaseTime.

SponsorshipTimeout SponsorshipTimeout SponsorshipTimeout SponsorshipTimeout

Obtiene o establece el tiempo que se espera para que un patrocinador devuelva el tiempo de renovación de la concesión.Gets or sets the amount of time to wait for a sponsor to return with a lease renewal time.

Métodos

Register(ISponsor) Register(ISponsor) Register(ISponsor) Register(ISponsor)

Registra un patrocinador para la concesión sin renovarla.Registers a sponsor for the lease without renewing the lease.

Register(ISponsor, TimeSpan) Register(ISponsor, TimeSpan) Register(ISponsor, TimeSpan) Register(ISponsor, TimeSpan)

Registra un patrocinador de la concesión y lo renueva mediante el TimeSpan especificado.Registers a sponsor for the lease, and renews it by the specified TimeSpan.

Renew(TimeSpan) Renew(TimeSpan) Renew(TimeSpan) Renew(TimeSpan)

Renueva una concesión por el tiempo especificado.Renews a lease for the specified time.

Unregister(ISponsor) Unregister(ISponsor) Unregister(ISponsor) Unregister(ISponsor)

Quita a un patrocinador de la lista de patrocinadores.Removes a sponsor from the sponsor list.

Se aplica a