ThreadPoolTimer 类

定义

命名空间:

Windows.System.Threading

表示使用 CreateTimer 或 CreatePeriodicTimer 创建的计时器。

注意

桌面和 UWP 应用支持 ThreadPool API。

public ref class ThreadPoolTimer sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ThreadPoolTimer final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class ThreadPoolTimer

Public NotInheritable Class ThreadPoolTimer

继承

Object Platform::Object IInspectable ThreadPoolTimer

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

示例

以下代码演示如何通过传入 TimerElapsedHandler 委托方法创建定期计时器。

int period = 1000;

ThreadPoolTimer PeriodicTimer =
    ThreadPoolTimer.CreatePeriodicTimer(ExampleTimerElapsedHandler,
                                        TimeSpan.FromMilliseconds(period));

使用计时器完成应用后，应将其取消。 以下代码取消在上一示例中创建的定期计时器。

if (PeriodicTimer != null)
{
    PeriodicTimer.Cancel();
}

注解

CreatePeriodicTimer 或 CreateTimer 方法可用于创建此对象。

注意

如果 TimeSpan 值为零 (或任何小于 1 毫秒) 的值，则定期计时器将充当单次计时器。

属性

Delay	获取使用 CreateTimer 创建的一次性计时器的超时值。
Period	获取使用 CreatePeriodicTimer 创建的定期计时器的超时值。

方法

Cancel()	取消计时器。
CreatePeriodicTimer(TimerElapsedHandler, TimeSpan)	创建定期计时器。
CreatePeriodicTimer(TimerElapsedHandler, TimeSpan, TimerDestroyedHandler)	创建定期计时器，并指定要在定期计时器完成后调用的方法。 当计时器过期且未重新激活并且处理程序的最终调用已完成时，定期 计时器将完成 。
CreateTimer(TimerElapsedHandler, TimeSpan)	创建一次性计时器。
CreateTimer(TimerElapsedHandler, TimeSpan, TimerDestroyedHandler)	创建一个一次性计时器，并指定要在计时器完成后调用的方法。 计时器过期且处理程序的最终调用完成时， 计时器将完成 。