ThreadPoolTimer Clase

Definición

Espacio de nombres:

Windows.System.Threading

Representa un temporizador creado con CreateTimer o CreatePeriodicTimer.

Nota:

ThreadPool API es compatible con aplicaciones de escritorio y para 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

Herencia

Object Platform::Object IInspectable ThreadPoolTimer

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Ejemplos

En el código siguiente se muestra la creación de un temporizador periódico pasando un método delegado TimerElapsedHandler .

int period = 1000;

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

Cuando la aplicación haya terminado de usar el temporizador, se debe cancelar. El código siguiente cancela el temporizador periódico creado en el ejemplo anterior.

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

Comentarios

El método CreatePeriodicTimer o CreateTimer se puede usar para crear este objeto.

Nota:

Un valor TimeSpan de cero (o cualquier valor inferior a 1 milisegundos) hará que el temporizador periódico se comporte como un temporizador de un solo disparo.

Propiedades

Delay	Obtiene el valor de tiempo de espera de un temporizador de un solo uso creado con CreateTimer.
Period	Obtiene el valor de tiempo de espera de un temporizador periódico creado con CreatePeriodicTimer.

Métodos

Cancel()	Cancela un temporizador.
CreatePeriodicTimer(TimerElapsedHandler, TimeSpan)	Crea un temporizador periódico.
CreatePeriodicTimer(TimerElapsedHandler, TimeSpan, TimerDestroyedHandler)	Crea un temporizador periódico y especifica un método al que llamar una vez completado el temporizador periódico. El temporizador periódico se completa cuando el temporizador ha expirado sin reactivarse y la llamada final al controlador ha finalizado.
CreateTimer(TimerElapsedHandler, TimeSpan)	Crea un temporizador de un solo uso.
CreateTimer(TimerElapsedHandler, TimeSpan, TimerDestroyedHandler)	Crea un temporizador de un solo uso y especifica un método al que llamar una vez completado el temporizador. El temporizador se completa cuando el temporizador ha expirado y ha finalizado la llamada final al controlador .