ThreadPoolTimer Classe

  • Referência

Definição

Namespace:
Windows.System.Threading
Editar

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.

Aplica-se a