Clock.TickCount Propriedade

Definição

Namespace:

Microsoft.VisualBasic.Devices

Assembly:

Microsoft.VisualBasic.Forms.dll

Obtém a contagem de milissegundos do timer do sistema do computador.

public:
 property int TickCount { int get(); };

public int TickCount { get; }

member this.TickCount : int

Public ReadOnly Property TickCount As Integer

Valor da propriedade

Int32

Um Integer que contém a contagem de milissegundos do timer do sistema do computador.

Exemplos

O exemplo a seguir usa a My.Computer.Clock.TickCount propriedade para executar uma tarefa em um loop por um determinado número de segundos, mesmo que o tempo do sistema do computador seja alterado enquanto ele é executado.

Public Sub LoopTask(ByVal secondsToRun As Integer)
    Dim startTicks As Integer = My.Computer.Clock.TickCount
    Do While IsTimeUp(startTicks, secondsToRun)
        ' Code to run for at least secondsToRun seconds goes here.
    Loop
End Sub

Private Function IsTimeUp( 
    ByVal startTicks As Integer, 
    ByVal seconds As Integer 
) As Boolean
    ' This function throws an overflow exception if the
    ' tick count difference is greater than 2,147,483,647,  
    ' about 24 days for My.Computer.Clock.TickCount.

    ' Use UInteger to simplify the code for roll over.
    Dim uStart As UInteger = 
        CUInt(CLng(startTicks) - Integer.MinValue)
    Dim uCurrent As UInteger = 
        CUInt(CLng(My.Computer.Clock.TickCount) - Integer.MinValue)

    ' Calculate the tick count difference.
    Dim tickCountDifference As UInteger
    If uStart <= uCurrent Then
        tickCountDifference = uCurrent - uStart
    Else
        ' Tick count rolled over.
        tickCountDifference = UInteger.MaxValue - (uStart - uCurrent)
    End If

    ' Convert seconds to milliseconds and compare.
    Return CInt(tickCountDifference) < (seconds * 1000)
End Function

Comentários

A TickCount propriedade fornece acesso ao temporizador do sistema do computador, que é executado quando o computador está ativo. A resolução do temporizador não é inferior a 500 milissegundos.

Você pode usar essa propriedade para tornar o comportamento do aplicativo dependente do período de tempo em execução ou usá-lo para rotular eventos, ambos independentes do relógio do computador.

Cuidado

Quando o valor da TickCount propriedade atinge o valor inteiro máximo (MaxValue), ele salta para o valor inteiro mínimo (MinValue), um número negativo e continua a incrementar.

Se o computador for executado continuamente, TickCount incrementará de zero para o valor inteiro máximo em aproximadamente 24,9 dias.

A TickCount propriedade incrementa somente quando o sistema operacional está em execução; ele pausa quando o computador entra em determinados modos de economia de energia, como espera ou hibernação. A TickCount propriedade não está relacionada à configuração do relógio do computador.

Use a LocalTime propriedade ou GmtTime a propriedade para obter a data e a hora locais atuais neste computador.

A My.Computer.Clock.TickCount propriedade tem o mesmo comportamento que a Environment.TickCount propriedade .

Disponibilidade por tipo de projeto

Tipo de projeto	Disponível
Aplicativo do Windows	Sim
Biblioteca de Classes	Sim
Aplicativo do Console	Sim
Biblioteca de Controle do Windows	Sim
Biblioteca de Controles da Web	Sim
Serviço do Windows	Sim
Site	Sim

Confira também

• TickCount
• Objetos (Visual Basic)