ThreadPoolTimer Classe

Riferimento

Definizione

Spazio dei nomi:: Windows.System.Threading

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

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: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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

Condividi tramite