Ler em inglês

Compartilhar via


Timer Construtores

Definição

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Inicializa uma nova instância da classe Timer.

Sobrecargas

Timer()

Inicializa uma nova instância da classe Timer e define todas as propriedades para seus valores iniciais.

Timer(Double)

Inicializa uma nova instância da classe Timer e define a propriedade Interval como o número especificado de milissegundos.

Timer(TimeSpan)

Inicializa uma nova instância da Timer classe , definindo a Interval propriedade como o período especificado.

Timer()

Origem:
Timer.cs
Origem:
Timer.cs
Origem:
Timer.cs

Inicializa uma nova instância da classe Timer e define todas as propriedades para seus valores iniciais.

public Timer();

Exemplos

O exemplo a seguir cria uma instância de um Timer objeto que dispara seu Timer.Elapsed evento a cada dois segundos (2000 milissegundos), configura um manipulador de eventos para o evento e inicia o temporizador. O manipulador de eventos exibe o valor da ElapsedEventArgs.SignalTime propriedade sempre que ela é gerada.

using System;
using System.Timers;

public class Example
{
    private static Timer aTimer;

    public static void Main()
    {
        // Create a timer and set a two second interval.
        aTimer = new System.Timers.Timer();
        aTimer.Interval = 2000;

        // Hook up the Elapsed event for the timer. 
        aTimer.Elapsed += OnTimedEvent;

        // Have the timer fire repeated events (true is the default)
        aTimer.AutoReset = true;

        // Start the timer
        aTimer.Enabled = true;

        Console.WriteLine("Press the Enter key to exit the program at any time... ");
        Console.ReadLine();
    }

    private static void OnTimedEvent(Object source, System.Timers.ElapsedEventArgs e)
    {
        Console.WriteLine("The Elapsed event was raised at {0}", e.SignalTime);
    }
}
// The example displays output like the following: 
//       Press the Enter key to exit the program at any time... 
//       The Elapsed event was raised at 5/20/2015 8:48:58 PM 
//       The Elapsed event was raised at 5/20/2015 8:49:00 PM 
//       The Elapsed event was raised at 5/20/2015 8:49:02 PM 
//       The Elapsed event was raised at 5/20/2015 8:49:04 PM 
//       The Elapsed event was raised at 5/20/2015 8:49:06 PM

Comentários

A tabela a seguir mostra valores de propriedade iniciais para uma instância do Timer.

Propriedade Valor inicial
AutoReset true
Enabled false
Interval 100 milissegundos
SynchronizingObject Uma referência nula (Nothing no Visual Basic).

Confira também

Aplica-se a

.NET 10 e outras versões
Produto Versões
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

Timer(Double)

Origem:
Timer.cs
Origem:
Timer.cs
Origem:
Timer.cs

Inicializa uma nova instância da classe Timer e define a propriedade Interval como o número especificado de milissegundos.

public Timer(double interval);

Parâmetros

interval
Double

O tempo, em milissegundos, entre eventos. O valor deve ser maior que zero e menor ou igual a Int32.MaxValue.

Exceções

O valor do interval parâmetro é menor ou igual a zero ou maior que Int32.MaxValue.

Exemplos

O exemplo a seguir cria uma instância de um Timer objeto que dispara seu Timer.Elapsed evento a cada dois segundos (2000 milissegundos), configura um manipulador de eventos para o evento e inicia o temporizador. O manipulador de eventos exibe o valor da ElapsedEventArgs.SignalTime propriedade sempre que ela é gerada.

using System;
using System.Threading.Tasks;
using System.Timers;

class Example
{
   static void Main()
   {
      Timer timer = new Timer(1000);
      timer.Elapsed += async ( sender, e ) => await HandleTimer();
      timer.Start();
      Console.Write("Press any key to exit... ");
      Console.ReadKey();
   }

   private static Task HandleTimer()
   {
     Console.WriteLine("\nHandler not implemented..." );
     throw new NotImplementedException();
   }
}
// The example displays output like the following:
//   Press any key to exit...
//   Handler not implemented...
//   
//   Unhandled Exception: System.NotImplementedException: The method or operation is not implemented.
//      at Example.HandleTimer()
//      at Example.<<Main>b__0>d__2.MoveNext()
//   --- End of stack trace from previous location where exception was thrown ---
//      at System.Runtime.CompilerServices.AsyncMethodBuilderCore.<>c__DisplayClass2.<ThrowAsync>b__5(Object state)
//      at System.Threading.ExecutionContext.RunInternal(ExecutionContext executionContext, ContextCallback callback, Object state, Boolean preserveSyncCtx)
//      at System.Threading.ExecutionContext.Run(ExecutionContext executionContext, ContextCallback callback, Object state, Boolean preserveSyncCtx)
//      at System.Threading.QueueUserWorkItemCallback.System.Threading.IThreadPoolWorkItem.ExecuteWorkItem()
//      at System.Threading.ThreadPoolWorkQueue.Dispatch()

Comentários

Esse construtor define a Interval propriedade da nova instância do temporizador, mas não habilita o temporizador.

Confira também

Aplica-se a

.NET 10 e outras versões
Produto Versões
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

Timer(TimeSpan)

Origem:
Timer.cs
Origem:
Timer.cs
Origem:
Timer.cs

Inicializa uma nova instância da Timer classe , definindo a Interval propriedade como o período especificado.

public Timer(TimeSpan interval);

Parâmetros

interval
TimeSpan

O tempo entre os eventos. O valor em milissegundos deve ser maior que zero e menor que ou igual a MaxValue.

Aplica-se a

.NET 10 e outras versões
Produto Versões
.NET 7, 8, 9, 10