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

Distribuir controles de la colección de elementos no utilizados cuando se pueden eliminar las aplicaciones de servidor.Distributed garbage collection controls when server applications can be deleted. Tradicionalmente, colección de elementos no utilizados distribuida utiliza recuentos de referencias y hacer ping para el control.Traditionally, distributed garbage collection uses reference counts and pinging for control. Esto funciona bien cuando hay pocos 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 distribuido tradicional 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 con 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 en el dominio.Each AppDomain contains a lease manager that administers the leases in the domain. El Administrador de concesiones examina periódicamente las concesiones de caducidad de 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 renovarse invocando a uno o varios de los patrocinadores.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 las directivas y los métodos que renovación el período de concesión.A lease contains properties that determine its policies, and methods that renew the lease time. La concesión expone el ILease interfaz.The lease exposes the ILease interface.

Para obtener un ejemplo que muestra cómo usar el ILease vea interfaz duraciones.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