ThreadPoolTimer Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
- Atributos
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 . |