Idioma

ThreadPoolTimer Classe

Definição

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

Requisitos do Windows

Requisitos Description
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

Nome Description
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

Nome Description
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.

Aplica-se a