Usar um temporizador para enviar um item de trabalho

APIs importantes

Aprenda a criar um item de trabalho que seja executado após o fim de um temporizador.

Crie um temporizador de disparo único

Use o método CreateTimer para criar um temporizador para o item de trabalho. Forneça um lambda que realize o trabalho e use o parâmetro de atraso para especificar quanto tempo o pool de threads espera antes de poder atribuir o item de trabalho a um thread disponível. O atraso é especificado usando uma estrutura TimeSpan .

Observação

Nas aplicações do WinUI 3, usa DispatcherQueue.TryEnqueue o from Microsoft.UI.Dispatching.DispatcherQueue para aceder ao tópico da interface e mostrar o progresso do item de trabalho. Consulte a visão geral do DispatcherQueue para mais detalhes.

O exemplo seguinte cria um item de trabalho que se executa em três minutos:

TimeSpan delay = TimeSpan.FromMinutes(3);
            
ThreadPoolTimer DelayTimer = ThreadPoolTimer.CreateTimer(
    (source) =>
    {
        //
        // TODO: Work
        //
        
        //
        // Update the UI thread by using the UI core dispatcher.
        //
        Dispatcher.RunAsync(
            CoreDispatcherPriority.High,
            () =>
            {
                //
                // UI components can be accessed within this scope.
                //

            });

    }, delay);

TimeSpan delay;
delay.Duration = 3 * 60 * 10000000; // 10,000,000 ticks per second

ThreadPoolTimer ^ DelayTimer = ThreadPoolTimer::CreateTimer(
        ref new TimerElapsedHandler([this](ThreadPoolTimer^ source)
        {
            //
            // TODO: Work
            //
            
            //
            // Update the UI thread by using the UI core dispatcher.
            //
            Dispatcher->RunAsync(CoreDispatcherPriority::High,
                ref new DispatchedHandler([this]()
                {
                    //
                    // UI components can be accessed within this scope.
                    //

                    ExampleUIUpdateMethod("Timer completed.");

                }));

        }), delay);

Fornecer um tratador de completação

Se necessário, trate do cancelamento e da conclusão do item de trabalho com um TimerDestroyedHandler. Utilize a sobrecarga de CreateTimer para especificar uma expressão lambda adicional. Este é executado quando o temporizador é cancelado ou quando o trabalho é concluído.

O exemplo seguinte cria um temporizador que submete o item de trabalho e chama um método quando o item termina ou o temporizador é cancelado:

TimeSpan delay = TimeSpan.FromMinutes(3);
            
bool completed = false;

ThreadPoolTimer DelayTimer = ThreadPoolTimer.CreateTimer(
    (source) =>
    {
        //
        // TODO: Work
        //

        //
        // Update the UI thread by using the UI core dispatcher.
        //
        Dispatcher.RunAsync(
                CoreDispatcherPriority.High,
                () =>
                {
                    //
                    // UI components can be accessed within this scope.
                    //

                });

        completed = true;
    },
    delay,
    (source) =>
    {
        //
        // TODO: Handle work cancellation/completion.
        //


        //
        // Update the UI thread by using the UI core dispatcher.
        //
        Dispatcher.RunAsync(
            CoreDispatcherPriority.High,
            () =>
            {
                //
                // UI components can be accessed within this scope.
                //

                if (completed)
                {
                    // Timer completed.
                }
                else
                {
                    // Timer cancelled.
                }

            });
    });

TimeSpan delay;
delay.Duration = 3 * 60 * 10000000; // 10,000,000 ticks per second

completed = false;

ThreadPoolTimer ^ DelayTimer = ThreadPoolTimer::CreateTimer(
        ref new TimerElapsedHandler([&](ThreadPoolTimer ^ source)
        {
            //
            // TODO: Work
            //

            //
            // Update the UI thread by using the UI core dispatcher.
            //
            Dispatcher->RunAsync(CoreDispatcherPriority::High,
                ref new DispatchedHandler([&]()
                {
                    //
                    // UI components can be accessed within this scope.
                    //

                }));

            completed = true;

        }),
        delay,
        ref new TimerDestroyedHandler([&](ThreadPoolTimer ^ source)
        {
            //
            // TODO: Handle work cancellation/completion.
            //

            Dispatcher->RunAsync(CoreDispatcherPriority::High,
                ref new DispatchedHandler([&]()
                {
                    //
                    // Update the UI thread by using the UI core dispatcher.
                    //

                    if (completed)
                    {
                        // Timer completed.
                    }
                    else
                    {
                        // Timer cancelled.
                    }

                }));
        }));

Cancelar o temporizador

Se o temporizador ainda estiver em contagem decrescente, mas o item de trabalho já não for necessário, selecione Cancelar. O temporizador é cancelado e o item de trabalho não será submetido ao pool de tópicos.

DelayTimer.Cancel();

DelayTimer->Cancel();

Remarks

As aplicações do Windows devem evitar o Thread.Sleep porque bloqueia o thread que chama, o que pode tornar a interface pouco responsiva se for chamada no thread UI. Podes usar um ThreadPoolTimer para criar um item de trabalho em vez disso, e isto vai atrasar a tarefa realizada pelo item de trabalho sem bloquear o thread da interface.

Consulte o exemplo de agrupamento de threads para ver um exemplo de código completo que demonstra itens de trabalho, itens de trabalho com temporizador e itens de trabalho periódicos. O exemplo de código foi originalmente escrito para o Windows 8.1, mas o código pode ser reutilizado no Windows 10.

Para informações sobre temporizadores repetidos, consulte Criar um item de trabalho periódico.

  • Last updated on