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+ 主线程回调。不复杂但容易忽略生命周期管理。
