DispatcherQueueTimer Classe

Référence

Définition

Espace de noms:: Windows.System

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

Exécute régulièrement une tâche sur un thread DispatcherQueue après l’expiration d’un intervalle de temps.

public ref class DispatcherQueueTimer sealed

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

/// [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)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class DispatcherQueueTimer

[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

Héritage: Object Platform::Object IInspectable DispatcherQueueTimer

Attributs: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 Fall Creators Update (introduit dans 10.0.16299.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v5.0)

Exemples

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;

Remarques

Le système garantit d’appeler le gestionnaire d’événements uniquement après l’expiration de la durée spécifiée. Toutefois, il peut y avoir un certain délai avant l’appel du gestionnaire de ticks s’il existe d’autres éléments de travail en attente dans la file d’attente.

Les tâches du minuteur s’exécutent à une priorité inférieure à inactivité.

Les minuteurs ne gardent pas la boucle d’événements DispatcherQueue active. Les minuteurs créés après l’arrêt de la boucle d’événements DispatcherQueue ne seront pas traités.

Propriétés

Interval	Obtient et définit l’intervalle pour le minuteur.
IsRepeating	Indique si le minuteur se répète.
IsRunning	Indique si le minuteur est en cours d’exécution.

Méthodes

Start()	Démarre la minuterie.
Stop()	Arrête la minuterie.

Événements

Tick	Événement qui se déclenche lorsque l’intervalle du minuteur s’écoule .

S’applique à

Partager via