Timer.Purge 方法

定义

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

从此计时器的任务队列中删除所有已取消的任务。

[Android.Runtime.Register("purge", "()I", "GetPurgeHandler")]
public virtual int Purge();

[<Android.Runtime.Register("purge", "()I", "GetPurgeHandler")>]
abstract member Purge : unit -> int
override this.Purge : unit -> int

Int32

从队列中删除的任务数。

从此计时器的任务队列中删除所有已取消的任务。 调用此方法不会影响计时器的行为，但消除了对队列中已取消的任务的引用。如果没有对这些任务的外部引用，它们就有资格进行垃圾回收。

大多数程序都无需调用此方法。它旨在供取消大量任务的罕见应用程序使用。调用此方法可交易空间时间：该方法的运行时可能与 n + c 日志 n 成正比，其中 n 是队列中的任务数，c 是已取消的任务数。

请注意，允许从此计时器上计划的任务内调用此方法。

在 1.5 中添加。

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改，并根据 Creative Commons 2.5 属性许可证中所述的术语使用。