MAUI怎么实现一个计时器功能 MAUI Timer使用方法

MAUI作为跨平台的应用开发框架，提供了多种实现计时器功能的方式，开发者可以根据具体的使用场景选择合适的方案。计时器的核心作用是按照设定的时间间隔周期性执行指定的逻辑，或者实现单次延迟执行的效果。

MAUI中常见的计时器类型

MAUI开发中常用的计时器主要有两种，分别是System_Timers_Timer和DispatcherTimer，两者的适用场景有一定区别。

• System_Timers_Timer：属于.NET基础类库的计时器，执行回调的线程不是UI线程，适合执行后台耗时任务，不能直接操作UI元素。
• DispatcherTimer：MAUI提供的UI线程计时器，回调会在UI线程执行，可以直接更新页面上的UI元素，适合需要更新界面的计时场景。

System_Timers_Timer使用方法

如果计时任务不需要操作UI，或者需要在后台执行耗时逻辑，可以选择使用System_Timers_Timer，使用时需要注意跨线程访问UI的问题。

基础使用示例

下面的代码演示了创建System_Timers_Timer，设置间隔为1秒，每隔1秒输出一次当前时间，同时更新UI上的计时显示。

using System.Timers;
using Microsoft.Maui.Controls;

namespace MauiTimerDemo;

public partial class MainPage : ContentPage
{
    // 声明计时器对象
    private Timer _systemTimer;
    // 记录计时次数
    private int _tickCount = 0;

    public MainPage()
    {
        InitializeComponent();
        InitSystemTimer();
    }

    private void InitSystemTimer()
    {
        // 创建计时器实例，设置间隔为1000毫秒（1秒）
        _systemTimer = new Timer(1000);
        // 绑定计时器触发事件
        _systemTimer.Elapsed += SystemTimer_Elapsed;
        // 设置自动重置，true表示每次间隔后都会触发，false表示只触发一次
        _systemTimer.AutoReset = true;
    }

    private void SystemTimer_Elapsed(object sender, ElapsedEventArgs e)
    {
        _tickCount++;
        // 因为回调不在UI线程，更新UI需要使用MainThread.BeginInvokeOnMainThread
        MainThread.BeginInvokeOnMainThread(() =>
        {
            // 更新页面上的标签显示
            SystemTimerLabel.Text = $"System_Timers_Timer 触发次数：{_tickCount}，当前时间：{DateTime.Now:HH:mm:ss}";
        });
    }

    private void StartSystemTimer_Clicked(object sender, EventArgs e)
    {
        // 启动计时器
        _systemTimer.Start();
    }

    private void StopSystemTimer_Clicked(object sender, EventArgs e)
    {
        // 停止计时器
        _systemTimer.Stop();
        _tickCount = 0;
        SystemTimerLabel.Text = "System_Timers_Timer 已停止";
    }
}

页面XAML布局

对应的页面布局代码如下，包含两个按钮分别控制计时器的启动和停止，以及一个标签显示计时信息。

<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="MauiTimerDemo.MainPage">
    <VerticalStackLayout Spacing="20" Padding="30" VerticalOptions="Center">
        <Label Text="System_Timers_Timer 演示" FontSize="20" />
        <Label x:Name="SystemTimerLabel" Text="未启动" FontSize="16" />
        <HorizontalStackLayout Spacing="10">
            <Button Text="启动计时器" Clicked="StartSystemTimer_Clicked" />
            <Button Text="停止计时器" Clicked="StopSystemTimer_Clicked" />
        </HorizontalStackLayout>
    </VerticalStackLayout>
</ContentPage>

DispatcherTimer使用方法

如果需要直接更新UI元素，不需要处理跨线程问题，使用DispatcherTimer会更加方便，它的回调默认在UI线程执行。

基础使用示例

下面的代码演示了DispatcherTimer的使用，实现每隔500毫秒更新一次倒计时显示的效果。

using Microsoft.Maui.Controls;

namespace MauiTimerDemo;

public partial class MainPage : ContentPage
{
    // 声明DispatcherTimer对象
    private DispatcherTimer _dispatcherTimer;
    // 倒计时初始值，单位秒
    private int _countdown = 10;

    public MainPage()
    {
        InitializeComponent();
        InitDispatcherTimer();
    }

    private void InitDispatcherTimer()
    {
        // 创建DispatcherTimer实例
        _dispatcherTimer = new DispatcherTimer();
        // 设置触发间隔为500毫秒
        _dispatcherTimer.Interval = TimeSpan.FromMilliseconds(500);
        // 绑定触发事件
        _dispatcherTimer.Tick += DispatcherTimer_Tick;
    }

    private void DispatcherTimer_Tick(object sender, EventArgs e)
    {
        _countdown--;
        // 直接更新UI，因为回调在UI线程执行
        DispatcherTimerLabel.Text = $"倒计时剩余：{_countdown} 秒";
        // 倒计时结束停止计时器
        if (_countdown <= 0)
        {
            _dispatcherTimer.Stop();
            DispatcherTimerLabel.Text = "倒计时结束";
        }
    }

    private void StartDispatcherTimer_Clicked(object sender, EventArgs e)
    {
        // 重置倒计时
        _countdown = 10;
        DispatcherTimerLabel.Text = $"倒计时剩余：{_countdown} 秒";
        // 启动计时器
        _dispatcherTimer.Start();
    }

    private void StopDispatcherTimer_Clicked(object sender, EventArgs e)
    {
        // 停止计时器
        _dispatcherTimer.Stop();
        _countdown = 10;
        DispatcherTimerLabel.Text = "DispatcherTimer 已停止";
    }
}

对应XAML布局

该示例的页面布局如下，同样包含控制按钮和显示标签。

<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="MauiTimerDemo.MainPage">
    <VerticalStackLayout Spacing="20" Padding="30" VerticalOptions="Center">
        <Label Text="DispatcherTimer 演示" FontSize="20" />
        <Label x:Name="DispatcherTimerLabel" Text="未启动" FontSize="16" />
        <HorizontalStackLayout Spacing="10">
            <Button Text="启动倒计时" Clicked="StartDispatcherTimer_Clicked" />
            <Button Text="停止倒计时" Clicked="StopDispatcherTimer_Clicked" />
        </HorizontalStackLayout>
    </VerticalStackLayout>
</ContentPage>

两种计时器的选择建议

实际开发中，如果计时任务需要更新页面元素，优先选择DispatcherTimer，可以减少跨线程处理的代码；如果是后台数据同步、日志写入等不需要操作UI的任务，选择System_Timers_Timer更合适。

注意事项

• 计时器使用完毕后，尤其是页面销毁时，要及时停止并释放资源，避免内存泄漏。可以在页面的OnDisappearing方法中停止计时器。
• 设置计时器间隔时，不要设置过短的时间，过短的间隔会导致UI线程压力过大，影响应用性能。
• 如果System_Timers_Timer的回调中需要执行耗时操作，建议将耗时逻辑放到后台线程执行，避免阻塞计时器的后续触发。

计时器的间隔时间是近似值，实际触发时间会受到系统调度、线程状态等因素的影响，不适合用于需要极高精度的定时场景。

MAUITimer计时器Dispatcher修改时间：2026-07-19 02:48:39