Timer Timer Timer Timer Class

Definição

Implementa um temporizador que aciona um evento em intervalos definidos pelo usuário.Implements a timer that raises an event at user-defined intervals. Esse temporizador é otimizado para uso em aplicativos do Windows Forms e deve ser usado em uma janela.This timer is optimized for use in Windows Forms applications and must be used in a window.

public ref class Timer : System::ComponentModel::Component
public class Timer : System.ComponentModel.Component
type Timer = class
    inherit Component
Public Class Timer
Inherits Component
Herança

Exemplos

O exemplo a seguir implementa um temporizador de intervalo simples, que aciona um alarme a cada cinco segundos.The following example implements a simple interval timer, which sets off an alarm every five seconds. Quando o alarme, for um MessageBox exibe uma contagem do número de vezes que o alarme foi iniciado e solicita ao usuário sobre se o temporizador deve continuar em execução.When the alarm occurs, a MessageBox displays a count of the number of times the alarm has started and prompts the user as to whether the timer should continue to run.

public ref class Class1
{
private:
   static System::Windows::Forms::Timer^ myTimer = gcnew System::Windows::Forms::Timer;
   static int alarmCounter = 1;
   static bool exitFlag = false;

   // This is the method to run when the timer is raised.
   static void TimerEventProcessor( Object^ /*myObject*/, EventArgs^ /*myEventArgs*/ )
   {
      myTimer->Stop();
      
      // Displays a message box asking whether to continue running the timer.
      if ( MessageBox::Show( "Continue running?", String::Format( "Count is: {0}", alarmCounter ), MessageBoxButtons::YesNo ) == DialogResult::Yes )
      {
         
         // Restarts the timer and increments the counter.
         alarmCounter += 1;
         myTimer->Enabled = true;
      }
      else
      {
         
         // Stops the timer.
         exitFlag = true;
      }
   }


public:
   static void Main()
   {
      
      /* Adds the event and the event handler for the method that will 
                process the timer event to the timer. */
      myTimer->Tick += gcnew EventHandler( TimerEventProcessor );
      
      // Sets the timer interval to 5 seconds.
      myTimer->Interval = 5000;
      myTimer->Start();
      
      // Runs the timer, and raises the event.
      while ( exitFlag == false )
      {
         
         // Processes all the events in the queue.
         Application::DoEvents();
      }
   }

};

int main()
{
   Class1::Main();
}

public class Class1 {
    static System.Windows.Forms.Timer myTimer = new System.Windows.Forms.Timer();
    static int alarmCounter = 1;
    static bool exitFlag = false;
 
    // This is the method to run when the timer is raised.
    private static void TimerEventProcessor(Object myObject,
                                            EventArgs myEventArgs) {
       myTimer.Stop();
 
       // Displays a message box asking whether to continue running the timer.
       if(MessageBox.Show("Continue running?", "Count is: " + alarmCounter, 
          MessageBoxButtons.YesNo) == DialogResult.Yes) {
          // Restarts the timer and increments the counter.
          alarmCounter +=1;
          myTimer.Enabled = true;
       }
       else {
          // Stops the timer.
          exitFlag = true;
       }
    }
 
    public static int Main() {
       /* Adds the event and the event handler for the method that will 
          process the timer event to the timer. */
       myTimer.Tick += new EventHandler(TimerEventProcessor);
 
       // Sets the timer interval to 5 seconds.
       myTimer.Interval = 5000;
       myTimer.Start();
 
       // Runs the timer, and raises the event.
       while(exitFlag == false) {
          // Processes all the events in the queue.
          Application.DoEvents();
       }
    return 0;
    }
 }
    
Public Class Class1
    Private Shared WithEvents myTimer As New System.Windows.Forms.Timer()
    Private Shared alarmCounter As Integer = 1
    Private Shared exitFlag As Boolean = False    
    
    ' This is the method to run when the timer is raised.
    Private Shared Sub TimerEventProcessor(myObject As Object, _
                                           ByVal myEventArgs As EventArgs) _
                                       Handles myTimer.Tick
        myTimer.Stop()
        
        ' Displays a message box asking whether to continue running the timer.
        If MessageBox.Show("Continue running?", "Count is: " & alarmCounter, _
                            MessageBoxButtons.YesNo) = DialogResult.Yes Then
            ' Restarts the timer and increments the counter.
            alarmCounter += 1
            myTimer.Enabled = True
        Else
            ' Stops the timer.
            exitFlag = True
        End If
    End Sub
    
    Public Shared Sub Main()
        ' Adds the event and the event handler for the method that will
        ' process the timer event to the timer.
        
        ' Sets the timer interval to 5 seconds.
        myTimer.Interval = 5000
        myTimer.Start()
        
        ' Runs the timer, and raises the event.
        While exitFlag = False
            ' Processes all the events in the queue.
            Application.DoEvents()
        End While

    End Sub    

End Class

Comentários

Um Timer é usado para acionar um evento em intervalos definidos pelo usuário.A Timer is used to raise an event at user-defined intervals. Esse temporizador do Windows foi projetado para um ambiente de thread único onde os threads de interface do usuário são usados para executar o processamento.This Windows timer is designed for a single-threaded environment where UI threads are used to perform processing. Ele requer que o código do usuário tiver uma bomba de mensagem da interface do usuário disponível e sempre funcionam do mesmo thread ou realizar marshaling da chamada em outro thread.It requires that the user code have a UI message pump available and always operate from the same thread, or marshal the call onto another thread.

Quando você usa esse temporizador, use o Tick evento para executar uma operação de sondagem ou para exibir uma tela inicial para um período de tempo especificado.When you use this timer, use the Tick event to perform a polling operation or to display a splash screen for a specified period of time. Sempre que o Enabled estiver definida como true e o Interval propriedade é maior que zero, o Tick é acionado em intervalos com base no Interval configuração da propriedade.Whenever the Enabled property is set to true and the Interval property is greater than zero, the Tick event is raised at intervals based on the Interval property setting.

Essa classe fornece métodos para definir o intervalo e para iniciar e parar o temporizador.This class provides methods to set the interval, and to start and stop the timer.

Observação

O componente de temporizador do Windows Forms é single-threaded e é limitado a uma precisão de milissegundos de 55.The Windows Forms Timer component is single-threaded, and is limited to an accuracy of 55 milliseconds. Se você precisar de um timer de vários threads com maior precisão, use o Timer classe o System.Timers namespace.If you require a multithreaded timer with greater accuracy, use the Timer class in the System.Timers namespace.

Construtores

Timer() Timer() Timer() Timer()

Inicializa uma nova instância da classe Timer.Initializes a new instance of the Timer class.

Timer(IContainer) Timer(IContainer) Timer(IContainer) Timer(IContainer)

Inicializa uma nova instância da classe Timer em conjunto com o contêiner especificado.Initializes a new instance of the Timer class together with the specified container.

Propriedades

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

Obtém um valor que indica se o componente pode acionar um evento.Gets a value indicating whether the component can raise an event.

(Inherited from Component)
Container Container Container Container

Obtém o IContainer que contém o Component.Gets the IContainer that contains the Component.

(Inherited from Component)
DesignMode DesignMode DesignMode DesignMode

Obtém um valor que indica se o Component está no modo de design no momento.Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
Enabled Enabled Enabled Enabled

Obtém ou define se o temporizador está em execução.Gets or sets whether the timer is running.

Events Events Events Events

Obtém a lista de manipuladores de eventos que estão anexados a este Component.Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
Interval Interval Interval Interval

Obtém ou define o tempo, em milissegundos, antes que o evento Tick seja gerado em relação à última ocorrência do evento Tick.Gets or sets the time, in milliseconds, before the Tick event is raised relative to the last occurrence of the Tick event.

Site Site Site Site

Obtém ou define o ISite do Component.Gets or sets the ISite of the Component.

(Inherited from Component)
Tag Tag Tag Tag

Obtém ou define uma cadeia de caracteres arbitrária que representa algum tipo de estado do usuário.Gets or sets an arbitrary string representing some type of user state.

Métodos

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto remoto.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

Libera todos os recursos usados pelo Component.Releases all resources used by the Component.

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Descarta os recursos, exceto a memória, usados pelo temporizador.Disposes of the resources, other than memory, used by the timer.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Retorna um objeto que representa um serviço fornecido pelo Component ou pelo seu Container.Returns an object that represents a service provided by the Component or by its Container.

(Inherited from Component)
GetType() GetType() GetType() GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Cria uma cópia superficial do objeto MarshalByRefObject atual.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
OnTick(EventArgs) OnTick(EventArgs) OnTick(EventArgs) OnTick(EventArgs)

Aciona o evento Tick.Raises the Tick event.

Start() Start() Start() Start()

Inicia o temporizador.Starts the timer.

Stop() Stop() Stop() Stop()

Interrompe o temporizador.Stops the timer.

ToString() ToString() ToString() ToString()

Retorna uma cadeia de caracteres que representa o Timer.Returns a string that represents the Timer.

Eventos

Disposed Disposed Disposed Disposed

Ocorre quando o componente é disposto por uma chamada para o método Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)
Tick Tick Tick Tick

Ocorre quando o intervalo especificado tiver terminado e o temporizador estiver habilitado.Occurs when the specified timer interval has elapsed and the timer is enabled.

Aplica-se a