MAui中推荐使用DispatcherTimer实现页面级计时功能,因其自动绑定UI线程,可直接更新控件;需在OnDisappearing中停止并释放,避免内存泄漏和计时异常。

MAUI 中没有直接叫 Timer 的控件,但你可以用 .net 原生的 System.Threading.Timer 或更推荐的 DispatcherTimer 实现页面级计时功能。关键在于:要在 UI 线程安全地更新界面,优先选 DispatcherTimer。
用 DispatcherTimer 实现秒级倒计时(推荐)
DispatcherTimer 自动绑定到当前页面的 UI 线程,触发事件时可直接操作 Label、Button 等控件,不用手动调度。
- 在页面类(如 MainPage.xaml.cs)中声明并初始化:
C#
private DispatcherTimer? _timer; private int _seconds = 60; public MainPage() { InitializeComponent(); StartTimer(); } private void StartTimer() { _timer = new DispatcherTimer { Interval = TimeSpan.FromSeconds(1) }; _timer.Tick += OnTimerTick; _timer.Start(); } private void OnTimerTick(object sender, EventArgs e) { _seconds--; CounterLabel.Text = $"剩余: {_seconds}s"; if (_seconds <= 0) { _timer?.Stop(); _timer?.Tick -= OnTimerTick; CounterLabel.Text = "时间到!"; } }
- 注意:务必在停止计时器后移除
Tick事件,避免内存泄漏或重复触发 - 如果需要暂停/恢复,保存状态 + 控制
Start()/Stop()即可
用 System.Threading.Timer 做后台定时任务(适合非 UI 场景)
适用于需长时间运行、不依赖页面生命周期的任务(如轮询 API),但更新 UI 时必须手动切回主线程:
- 示例:每 5 秒检查一次网络状态,并在界面上显示
C#
private Timer? _backgroundTimer; private void StartBackgroundTimer() { _backgroundTimer = new Timer(async _ => { // 后台线程执行耗时操作(如 HttpClient 调用) bool isOnline = await CheckNetworkAsync(); // 切回 UI 线程更新界面 MainThread.BeginInvokeOnMainThread(() => { StatusLabel.Text = isOnline ? "✅ 在线" : "❌ 离线"; }); }, null, TimeSpan.Zero, TimeSpan.FromSeconds(5)); }
- 别忘了在页面卸载(如
OnDisappearing)时调用_backgroundTimer?.Dispose() - 不适合直接更新绑定属性(如 MVVM 场景),需配合
INotifyPropertyChanged和主线程通知
结合 MVVM 模式使用(推荐给中大型项目)
在 ViewModel 中使用 DispatcherTimer 需获取当前 Dispatcher —— MAUI 提供了 MainThread.InvokeOnMainThreadAsync,但更稳妥的方式是把 timer 逻辑放在 View 层,或通过服务注入方式解耦:
- 定义一个
ITimerService接口,实现类中用DispatcherTimer并暴露Tick事件 - ViewModel 订阅该事件,通过
INotifyPropertyChanged通知 UI 更新 - 确保服务生命周期与页面一致,避免跨页面共享导致状态混乱
常见问题提醒
- 页面切换后计时器还在跑? —— 在
OnDisappearing中Stop()并取消事件订阅 - 计时不准(变慢或跳秒)? —— 不要用
Task.Delay循环模拟;DispatcherTimer的精度取决于 UI 帧率,一般够用;高精度需求用Stopwatch+ 主动校准 - android/ios 后台被挂起? —— 移动端退到后台后,所有 timer 都会暂停,无法持续倒计时;如需后台计时,需用平台特定方案(如 Android Foreground Service),MAUI 不原生支持
基本上就这些。日常倒计时、刷新 UI、轻量轮询,用 DispatcherTimer 最省心;纯后台任务再考虑 System.Threading.Timer + 主线程回调。不复杂但容易忽略生命周期管理。