Timer Classe

Definição

public ref class Timer sealed : IDisposable

public ref class Timer sealed : MarshalByRefObject, IDisposable

public ref class Timer sealed : MarshalByRefObject, IAsyncDisposable, IDisposable

[System.Runtime.InteropServices.ComVisible(true)]
public sealed class Timer : IDisposable

public sealed class Timer : MarshalByRefObject, IDisposable

[System.Runtime.InteropServices.ComVisible(true)]
public sealed class Timer : MarshalByRefObject, IDisposable

public sealed class Timer : MarshalByRefObject, IAsyncDisposable, IDisposable

[<System.Runtime.InteropServices.ComVisible(true)>]
type Timer = class
    interface IDisposable

type Timer = class
    inherit MarshalByRefObject
    interface IDisposable

[<System.Runtime.InteropServices.ComVisible(true)>]
type Timer = class
    inherit MarshalByRefObject
    interface IDisposable

type Timer = class
    inherit MarshalByRefObject
    interface IAsyncDisposable
    interface IDisposable

Public NotInheritable Class Timer
Implements IDisposable

Public NotInheritable Class Timer
Inherits MarshalByRefObject
Implements IDisposable

Public NotInheritable Class Timer
Inherits MarshalByRefObject
Implements IAsyncDisposable, IDisposable

Herança

Object

Timer

Herança

Object

MarshalByRefObject

Timer

Atributos

ComVisibleAttribute

Implementações

IDisposable IAsyncDisposable

Exemplos

O exemplo seguinte define uma StatusChecker classe que inclui um CheckStatus método cuja assinatura é igual à do TimerCallback delegado. O state argumento do CheckStatus método é um AutoResetEvent objeto usado para sincronizar o thread de aplicação e o thread pool de threads que executa o delegado de callback. A StatusChecker classe inclui também duas variáveis de estado:

invokeCount
Indica o número de vezes que o método de callback foi invocado.

maxCount
Determina o número máximo de vezes que o método de callback deve ser invocado.

O thread de aplicação cria o temporizador, que espera um segundo e depois executa o CheckStatus método de callback a cada 250 milissegundos. O thread da aplicação bloqueia então até que o AutoResetEvent objeto seja sinalizado. Quando o CheckStatus método de callback é maxCount executado vezes, chama o AutoResetEvent.Set método para definir o estado do AutoResetEvent objeto como sinalizado. Na primeira vez que isto acontece, o thread da aplicação chama o Change(Int32, Int32) método para que o método de callback seja agora executado a cada meio segundo. Bloqueia novamente até que o AutoResetEvent objeto seja sinalizado. Quando isto acontece, o temporizador é destruído ao chamar o seu Dispose método, e a aplicação termina.

using System;
using System.Threading;

class TimerExample
{
    static void Main()
    {
        // Create an AutoResetEvent to signal the timeout threshold in the
        // timer callback has been reached.
        var autoEvent = new AutoResetEvent(false);
        
        var statusChecker = new StatusChecker(10);

        // Create a timer that invokes CheckStatus after one second, 
        // and every 1/4 second thereafter.
        Console.WriteLine("{0:h:mm:ss.fff} Creating timer.\n", 
                          DateTime.Now);
        var stateTimer = new Timer(statusChecker.CheckStatus, 
                                   autoEvent, 1000, 250);

        // When autoEvent signals, change the period to every half second.
        autoEvent.WaitOne();
        stateTimer.Change(0, 500);
        Console.WriteLine("\nChanging period to .5 seconds.\n");

        // When autoEvent signals the second time, dispose of the timer.
        autoEvent.WaitOne();
        stateTimer.Dispose();
        Console.WriteLine("\nDestroying timer.");
    }
}

class StatusChecker
{
    private int invokeCount;
    private int  maxCount;

    public StatusChecker(int count)
    {
        invokeCount  = 0;
        maxCount = count;
    }

    // This method is called by the timer delegate.
    public void CheckStatus(Object stateInfo)
    {
        AutoResetEvent autoEvent = (AutoResetEvent)stateInfo;
        Console.WriteLine("{0} Checking status {1,2}.", 
            DateTime.Now.ToString("h:mm:ss.fff"), 
            (++invokeCount).ToString());

        if(invokeCount == maxCount)
        {
            // Reset the counter and signal the waiting thread.
            invokeCount = 0;
            autoEvent.Set();
        }
    }
}
// The example displays output like the following:
//       11:59:54.202 Creating timer.
//       
//       11:59:55.217 Checking status  1.
//       11:59:55.466 Checking status  2.
//       11:59:55.716 Checking status  3.
//       11:59:55.968 Checking status  4.
//       11:59:56.218 Checking status  5.
//       11:59:56.470 Checking status  6.
//       11:59:56.722 Checking status  7.
//       11:59:56.972 Checking status  8.
//       11:59:57.223 Checking status  9.
//       11:59:57.473 Checking status 10.
//       
//       Changing period to .5 seconds.
//       
//       11:59:57.474 Checking status  1.
//       11:59:57.976 Checking status  2.
//       11:59:58.476 Checking status  3.
//       11:59:58.977 Checking status  4.
//       11:59:59.477 Checking status  5.
//       11:59:59.977 Checking status  6.
//       12:00:00.478 Checking status  7.
//       12:00:00.980 Checking status  8.
//       12:00:01.481 Checking status  9.
//       12:00:01.981 Checking status 10.
//       
//       Destroying timer.

Imports System.Threading

Public Module Example
    Public Sub Main()
        ' Use an AutoResetEvent to signal the timeout threshold in the
        ' timer callback has been reached.
        Dim autoEvent As New AutoResetEvent(False)

        Dim statusChecker As New StatusChecker(10)

        ' Create a timer that invokes CheckStatus after one second, 
        ' and every 1/4 second thereafter.
        Console.WriteLine("{0:h:mm:ss.fff} Creating timer." & vbCrLf, 
                          DateTime.Now)
        Dim stateTimer As New Timer(AddressOf statusChecker.CheckStatus, 
                                    autoEvent, 1000, 250)

        ' When autoEvent signals, change the period to every half second.
        autoEvent.WaitOne()
        stateTimer.Change(0, 500)
        Console.WriteLine(vbCrLf & "Changing period to .5 seconds." & vbCrLf)

        ' When autoEvent signals the second time, dispose of the timer.
        autoEvent.WaitOne()
        stateTimer.Dispose()
        Console.WriteLine(vbCrLf & "Destroying timer.")
    End Sub
End Module

Public Class StatusChecker
    Dim invokeCount, maxCount As Integer 

    Sub New(count As Integer)
        invokeCount  = 0
        maxCount = count
    End Sub

    ' The timer callback method.
    Sub CheckStatus(stateInfo As Object)
        Dim autoEvent As AutoResetEvent = DirectCast(stateInfo, AutoResetEvent)
        invokeCount += 1
        Console.WriteLine("{0:h:mm:ss.fff} Checking status {1,2}.", 
                          DateTime.Now, invokeCount)
        If invokeCount = maxCount Then
            ' Reset the counter and signal the waiting thread.
            invokeCount = 0
            autoEvent.Set()
        End If
    End Sub
End Class
' The example displays output like the following:
'       11:59:54.202 Creating timer.
'       
'       11:59:55.217 Checking status  1.
'       11:59:55.466 Checking status  2.
'       11:59:55.716 Checking status  3.
'       11:59:55.968 Checking status  4.
'       11:59:56.218 Checking status  5.
'       11:59:56.470 Checking status  6.
'       11:59:56.722 Checking status  7.
'       11:59:56.972 Checking status  8.
'       11:59:57.223 Checking status  9.
'       11:59:57.473 Checking status 10.
'       
'       Changing period to .5 seconds.
'       
'       11:59:57.474 Checking status  1.
'       11:59:57.976 Checking status  2.
'       11:59:58.476 Checking status  3.
'       11:59:58.977 Checking status  4.
'       11:59:59.477 Checking status  5.
'       11:59:59.977 Checking status  6.
'       12:00:00.478 Checking status  7.
'       12:00:00.980 Checking status  8.
'       12:00:01.481 Checking status  9.
'       12:00:01.981 Checking status 10.
'       
'       Destroying timer.

Observações

Usa um TimerCallback delegado para especificar o método que queres que ele Timer execute. A assinatura do TimerCallback delegado é:

void TimerCallback(Object state)

Sub TimerCallback(state As Object)

O delegado do temporizador é especificado quando o temporizador é construído e não pode ser alterado. O método não se executa no thread que criou o temporizador; Executa-se numa ThreadPool thread fornecida pelo sistema.

Quando crias um temporizador, podes especificar um tempo de espera antes da primeira execução do método (tempo de vencimento) e um tempo de espera entre execuções subsequentes (ponto). A Timer classe tem a mesma resolução do relógio do sistema. Isto significa que, se o período for inferior à resolução do relógio do sistema, o delegado TimerCallback executará em intervalos definidos pela resolução do relógio do sistema, que é aproximadamente 15 milissegundos nos sistemas Windows 7 e Windows 8. Pode alterar o tempo e o período de devida, ou desativar o temporizador, usando o Change método.

Quando um temporizador deixar de ser necessário, use o Dispose método para libertar os recursos armazenados pelo temporizador. Note-se que os callbacks podem ocorrer depois de a Dispose() sobrecarga do método ter sido chamada, porque o temporizador coloca callbacks na fila para execução pelos threads do pool de threads. Podes usar o Dispose(WaitHandle) método overload para esperar até que todas as chamadas de retorno estejam concluídas.

O método de callback executado pelo temporizador deve ser reentrante, porque é chamado em ThreadPool threads. O callback pode ser executado simultaneamente em dois threads do pool de threads se o intervalo do temporizador for inferior ao tempo necessário para executar o callback, ou se todos os threads do pool de threads estiverem em uso e o callback for colocado em fila várias vezes.

Segurança de Thread

Este tipo é seguro para fios.

Ver também

• TimerCallback
• temporizadores
• O Conjunto de Fios Geridos