ThreadPoolTimer Classe

Définition

Espace de noms:

Windows.System.Threading

Représente un minuteur créé avec CreateTimer ou CreatePeriodicTimer.

Notes

L’API ThreadPool est prise en charge pour les applications de bureau et UWP.

public ref class ThreadPoolTimer sealed

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

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class ThreadPoolTimer

Public NotInheritable Class ThreadPoolTimer

Héritage

Object Platform::Object IInspectable ThreadPoolTimer

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Exemples

Le code suivant montre la création d’un minuteur périodique en passant une méthode de délégué TimerElapsedHandler .

int period = 1000;

ThreadPoolTimer PeriodicTimer =
    ThreadPoolTimer.CreatePeriodicTimer(ExampleTimerElapsedHandler,
                                        TimeSpan.FromMilliseconds(period));

Lorsque votre application est terminée à l’aide du minuteur, elle doit être annulée. Le code suivant annule le minuteur périodique créé dans l’exemple précédent.

if (PeriodicTimer != null)
{
    PeriodicTimer.Cancel();
}

Remarques

La méthode CreatePeriodicTimer ou CreateTimer peut être utilisée pour créer cet objet.

Notes

Une valeur TimeSpan de zéro (ou de toute valeur inférieure à 1 milliseconde) entraîne le comportement du minuteur périodique comme un minuteur à un seul coup.

Propriétés

Delay	Obtient la valeur de délai d’expiration d’un minuteur à usage unique créé avec CreateTimer.
Period	Obtient la valeur de délai d’expiration d’un minuteur périodique créé avec CreatePeriodicTimer.

Méthodes

Cancel()	Annule un minuteur.
CreatePeriodicTimer(TimerElapsedHandler, TimeSpan)	Crée un minuteur périodique.
CreatePeriodicTimer(TimerElapsedHandler, TimeSpan, TimerDestroyedHandler)	Crée un minuteur périodique et spécifie une méthode à appeler une fois le minuteur périodique terminé. Le minuteur périodique est terminé lorsque le minuteur a expiré sans être réactivé et que l’appel final au gestionnaire est terminé.
CreateTimer(TimerElapsedHandler, TimeSpan)	Crée un minuteur à usage unique.
CreateTimer(TimerElapsedHandler, TimeSpan, TimerDestroyedHandler)	Crée un minuteur à usage unique et spécifie une méthode à appeler une fois le minuteur terminé. Le minuteur est terminé lorsque le minuteur a expiré et que l’appel final au gestionnaire est terminé.