ThreadPoolTimer Classe

Definição

Namespace:

Windows.System.Threading

Representa um temporizador criado com CreateTimer ou CreatePeriodicTimer.

Observação

Há suporte para a API do ThreadPool para desktop, bem como para aplicativos 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

Herança

Object Platform::Object IInspectable ThreadPoolTimer

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Exemplos

O código a seguir mostra a criação de um temporizador periódico passando um método delegado TimerElapsedHandler .

int period = 1000;

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

Quando o aplicativo terminar de usar o temporizador, ele deverá ser cancelado. O código a seguir cancela o temporizador periódico criado no exemplo anterior.

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

Comentários

O método CreatePeriodicTimer ou CreateTimer pode ser usado para criar esse objeto.

Observação

Um valor TimeSpan de zero (ou qualquer valor menor que 1 milissegundo) fará com que o temporizador periódico se comporte como um temporizador de disparo único.

Propriedades

Delay	Obtém o valor de tempo limite de um temporizador de uso único criado com CreateTimer.
Period	Obtém o valor de tempo limite de um temporizador periódico criado com CreatePeriodicTimer.

Métodos

Cancel()	Cancela um temporizador.
CreatePeriodicTimer(TimerElapsedHandler, TimeSpan)	Cria um temporizador periódico.
CreatePeriodicTimer(TimerElapsedHandler, TimeSpan, TimerDestroyedHandler)	Cria um temporizador periódico e especifica um método a ser chamado após a conclusão do temporizador periódico. O temporizador periódico é concluído quando o temporizador expirou sem ser reativado e a chamada final para o manipulador foi concluída.
CreateTimer(TimerElapsedHandler, TimeSpan)	Cria um temporizador de uso único.
CreateTimer(TimerElapsedHandler, TimeSpan, TimerDestroyedHandler)	Cria um temporizador de uso único e especifica um método a ser chamado após a conclusão do temporizador. O temporizador é concluído quando o temporizador expirou e a chamada final para o manipulador foi concluída.