Menggunakan timer untuk mengirimkan item kerja

  • Artikel

API penting

Pelajari cara membuat item kerja yang berjalan setelah timer berlalu.

Membuat timer satu bidikan

Gunakan metode CreateTimer untuk membuat timer untuk item kerja. Berikan lambda yang menyelesaikan pekerjaan, dan gunakan parameter penundaan untuk menentukan berapa lama kumpulan utas menunggu sebelum dapat menetapkan item kerja ke utas yang tersedia. Penundaan ditentukan menggunakan struktur TimeSpan .

Catatan Anda dapat menggunakan CoreDispatcher.RunAsync untuk mengakses UI dan menampilkan kemajuan dari item kerja.

Contoh berikut membuat item kerja yang berjalan dalam tiga menit:

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);

Menyediakan handler penyelesaian

Jika diperlukan, tangani pembatalan dan penyelesaian item kerja dengan TimerDestroyedHandler. Gunakan kelebihan beban CreateTimer untuk menyediakan lambda tambahan. Ini berjalan ketika timer dibatalkan atau ketika item kerja selesai.

Contoh berikut membuat timer yang mengirimkan item kerja, dan memanggil metode saat item kerja selesai atau timer dibatalkan:

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.
                    }

                }));
        }));

Membatalkan timer

Jika timer masih menghitung mundur, tetapi item kerja tidak lagi diperlukan, panggil Batal. Timer dibatalkan dan item kerja tidak akan dikirimkan ke kumpulan utas.

DelayTimer.Cancel();

DelayTimer->Cancel();

Keterangan

aplikasi Platform Windows Universal (UWP) tidak dapat menggunakan Thread.Sleep karena dapat memblokir utas UI. Anda dapat menggunakan ThreadPoolTimer untuk membuat item kerja sebagai gantinya, dan ini akan menunda tugas yang diselesaikan oleh item kerja tanpa memblokir utas UI.

Lihat sampel kumpulan utas untuk sampel kode lengkap yang menunjukkan item kerja, item kerja timer, dan item kerja berkala. Sampel kode awalnya ditulis untuk Windows 8.1 tetapi kode dapat digunakan kembali dalam Windows 10.

Untuk informasi tentang pengulangan timer, lihat Membuat item kerja berkala.