C#怎么使用PeriodicTimer_C# .NET 6周期定时器方法教程【技巧】-C#.Net教程-PHP中文网

periodictimer是.net 6+中用于异步轮询的轻量级周期信号发生器，不执行用户代码，需配合while (await timer.waitfornexttickasync(ct))使用，不可替代system.threading.timer。

c#怎么使用periodictimer_c# .net 6周期定时器方法教程【技巧】

PeriodicTimer 在 .NET 6+ 中是推荐的轻量级周期性异步等待机制，但它不是“定时器回调”，不能直接替代 System.Threading.Timer 或 Timer 类；误用会导致任务堆积、取消失效或资源泄漏。

PeriodicTimer 的核心用途：配合 `WaitAsync` 实现可控的异步轮询

它本质是一个可等待的“周期信号发生器”，不执行任何用户代码，只在每个周期结束时让 WaitAsync 返回 true。典型场景是：你想每隔几秒检查一次状态（比如 HTTP 健康检查、队列长度、文件修改时间），且需要能响应取消、不阻塞线程、避免竞态。

必须搭配 while (await timer.WaitForNextTickAsync(cancellationToken)) 使用，不能单独 new 后就“启动”
不支持设置初始延迟（dueTime），首次触发总在构造后第一个周期点
内部使用 ThreadPool.UnsafeQueueUserWorkItem，无同步上下文捕获，适合后台服务而非 UI 线程

示例：

using var timer = new PeriodicTimer(TimeSpan.FromSeconds(2));
while (await timer.WaitForNextTickAsync(ct))
{
    // 这里执行你的逻辑，例如：if (IsReady()) ProcessNextItem();
}

为什么不能用 `PeriodicTimer` 替代 `System.Threading.Timer`

常见误解是把它当“新版 Timer”，但两者设计目标完全不同：System.Threading.Timer 是“到期即调用委托”，而 PeriodicTimer 是“让你自己决定何时检查并做啥”。一旦你在 WaitForNextTickAsync 后的处理逻辑耗时超过周期间隔，下一次等待会立刻返回 true（因为周期已到），导致逻辑连续执行、失去节流效果。

"避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

下载

错误写法（可能压垮服务）：

while (await timer.WaitForNextTickAsync(ct))
{
    await HeavyDatabaseQueryAsync(); // 若耗时 > 2s，则下次立即再进
}

正确做法是加节流判断或改用 Task.Delay + 循环（若需严格间隔）
若需“固定间隔执行”，应优先考虑 BackgroundService + Task.Delay，而非强行用 PeriodicTimer

`WaitForNextTickAsync` 的取消行为和资源释放细节

调用 cancellationToken 触发取消时，WaitForNextTickAsync 会立即抛出 OperationCanceledException，且 PeriodicTimer 自身不会持有引用或后台线程 —— 它纯粹依赖 ThreadPool 调度，所以只要及时 Dispose（推荐用 using），就不会泄漏。