ThreadPoolTimer Klasse

Definition

Namespace:

Windows.System.Threading

Stellt einen timer dar, der mit CreateTimer oder CreatePeriodicTimer erstellt wurde.

Hinweis

Die ThreadPool-API wird sowohl für Desktop- als auch für UWP-Apps unterstützt.

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

Vererbung

Object Platform::Object IInspectable ThreadPoolTimer

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

Der folgende Code zeigt die Erstellung eines regelmäßigen Timers durch Übergeben einer TimerElapsedHandler-Delegatmethode .

int period = 1000;

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

Wenn Ihre App den Timer verwendet, sollte sie abgebrochen werden. Der folgende Code bricht den im vorherigen Beispiel erstellten regelmäßigen Timer ab.

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

Hinweise

Zum Erstellen dieses Objekts kann die CreatePeriodicTimer - oder CreateTimer-Methode verwendet werden.

Hinweis

Ein TimeSpan-Wert von 0 (oder ein beliebiger Wert kleiner als 1 Millisekunde) bewirkt, dass sich der periodische Timer als Single-Shot-Timer verhält.

Eigenschaften

Delay	Ruft den Timeoutwert eines einmal verwendeten Timers ab, der mit CreateTimer erstellt wurde.
Period	Ruft den Timeoutwert eines regelmäßigen Timers ab, der mit CreatePeriodicTimer erstellt wurde.

Methoden

Cancel()	Bricht einen Timer ab.
CreatePeriodicTimer(TimerElapsedHandler, TimeSpan)	Erstellt einen regelmäßigen Timer.
CreatePeriodicTimer(TimerElapsedHandler, TimeSpan, TimerDestroyedHandler)	Erstellt einen periodischen Timer und gibt eine Methode an, die nach Abschluss des periodischen Timers aufgerufen werden soll. Der periodische Timer ist abgeschlossen, wenn der Timer abgelaufen ist, ohne erneut aktiviert zu werden, und der letzte Aufruf des Handlers abgeschlossen ist.
CreateTimer(TimerElapsedHandler, TimeSpan)	Erstellt einen Einmaligen Timer.
CreateTimer(TimerElapsedHandler, TimeSpan, TimerDestroyedHandler)	Erstellt einen Einmaligen Timer und gibt eine Methode an, die nach Abschluss des Timers aufgerufen werden soll. Der Timer ist abgeschlossen, wenn der Timer abgelaufen ist und der letzte Aufruf des Handlers abgeschlossen ist.