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

MAUI 中没有直接叫 Timer 的控件,但你可以用 .NET 原生的 System.Threading.Timer 或更推荐的 DispatcherTimer 实现页面级计时功能。关键在于:要在 UI 线程安全地更新界面,优先选 DispatcherTimer。
用 DispatcherTimer 实现秒级倒计时(推荐)
DispatcherTimer 自动绑定到当前页面的 UI 线程,触发事件时可直接操作 Label、Button 等控件,不用手动调度。
- 在页面类(如 MainPage.xaml.cs)中声明并初始化:
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 秒检查一次网络状态,并在界面上显示
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 + 主线程回调。不复杂但容易忽略生命周期管理。









