DispatcherQueueTimer 類別

定義

命名空間:

Windows.System

在經過時間間隔之後，定期在 DispatcherQueue 執行緒上執行工作。

public ref class DispatcherQueueTimer sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 327680)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class DispatcherQueueTimer final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 327680)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class DispatcherQueueTimer

Public NotInheritable Class DispatcherQueueTimer

繼承

Object Platform::Object IInspectable DispatcherQueueTimer

屬性

ContractVersionAttribute MarshalingBehaviorAttribute

Windows 需求

裝置系列	Windows 10 Fall Creators Update (已於 10.0.16299.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v5.0 引進)

範例

public void ConfigureRepeatingTimer()
{
    _queueController = DispatcherQueueController.CreateOnDedicatedThread();
    _queue = _queueController.DispatcherQueue;

    _repeatingTimer = _queue.CreateTimer ();
    _repeatingTimer.Interval = TimeSpan.FromSeconds(5);

    // The tick handler will be invoked repeatedly after every 5
    // seconds on the dedicated thread.
    _repeatingTimer.Tick += (s, e) =>
    {
        DoWork();
    };

    // Start the Timer
    _repeatingTimer.Start();
}

private DispatcherQueue _queue;
private DispatcherQueueController _queueController;
private DispatcherQueueTimer _repeatingTimer;

備註

系統保證只在指定的持續時間到期之後叫用事件處理常式。 不過，如果佇列中有其他擱置的工作專案，則叫用刻度處理常式之前可能會有一些延遲。

計時器工作會以低於閒置的優先順序執行。

計時器不會讓 DispatcherQueue 事件迴圈保持運作。 在 DispatcherQueue 事件迴圈停止之後建立的計時器將不會處理。

屬性

Interval	取得並設定計時器的間隔。
IsRepeating	指出計時器是否重複。
IsRunning	指出計時器目前是否正在執行。

方法

Start()	啟動計時器。
Stop()	停止計時器。

事件

Tick	計時器 間隔 經過時引發的事件。