Freigeben über


ThreadPoolTimer Klasse

Definition

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

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.

Gilt für: