Condividi tramite


ThreadPoolTimer Classe

Definizione

Rappresenta un timer creato con CreateTimer o CreatePeriodicTimer.

Nota

L'API ThreadPool è supportata per le app desktop e 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
Ereditarietà
Object Platform::Object IInspectable ThreadPoolTimer
Attributi

Requisiti Windows

Famiglia di dispositivi
Windows 10 (è stato introdotto in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Esempio

Il codice seguente illustra la creazione di un timer periodico passando un metodo delegato TimerElapsedHandler .

int period = 1000;

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

Al termine dell'uso del timer, l'app deve essere annullata. Il codice seguente annulla il timer periodico creato nell'esempio precedente.

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

Commenti

Per creare questo oggetto, è possibile utilizzare il metodo CreatePeriodicTimer o CreateTimer .

Nota

Un valore TimeSpan pari a zero (o qualsiasi valore minore di 1 millisecondo) causerà il comportamento del timer periodico come timer singolo.

Proprietà

Delay

Ottiene il valore di timeout di un timer a uso singolo creato con CreateTimer.

Period

Ottiene il valore di timeout di un timer periodico creato con CreatePeriodicTimer.

Metodi

Cancel()

Annulla un timer.

CreatePeriodicTimer(TimerElapsedHandler, TimeSpan)

Crea un timer periodico.

CreatePeriodicTimer(TimerElapsedHandler, TimeSpan, TimerDestroyedHandler)

Crea un timer periodico e specifica un metodo da chiamare al termine del timer periodico. Il timer periodico viene completato quando il timer è scaduto senza essere riattivato e la chiamata finale al gestore è stata completata .

CreateTimer(TimerElapsedHandler, TimeSpan)

Crea un timer a uso singolo.

CreateTimer(TimerElapsedHandler, TimeSpan, TimerDestroyedHandler)

Crea un timer a uso singolo e specifica un metodo da chiamare al termine del timer. Il timer viene completato quando il timer è scaduto e la chiamata finale al gestore è stata completata .

Si applica a