Clock.TickCount Propriedade

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

public int TickCount { get; }

member this.TickCount : int

Public ReadOnly Property TickCount As Integer

Valor de Propriedade

An Integer contendo a contagem de milissegundos do temporizador do sistema do computador.

Exemplos

O exemplo seguinte usa a My.Computer.Clock.TickCount propriedade de executar uma tarefa num ciclo durante um dado número de segundos, mesmo que o tempo do sistema do computador mude enquanto está a correr.

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

Observações

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

Pode usar esta propriedade para tornar o comportamento da sua aplicação dependente do tempo que esteve a funcionar, ou pode usá-la para rotular eventos, ambos independentes do relógio do computador.

Se o computador funcionar continuamente, TickCount incrementa de zero até ao valor inteiro máximo em aproximadamente 24,9 dias.

A TickCount propriedade só aumenta quando o sistema operativo está a funcionar; pausa quando o computador entra em certos modos de poupança de energia, como standby ou hibernação. A TickCount propriedade não está relacionada com a configuração do relógio do computador.

Use a LocalTime propriedade ou GmtTime propriedade para obter a data e 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

Ver também

• TickCount
• Objects (Visual Basic)