# Clock.TickCount Propriété

## Définition

Obtient le nombre de millisecondes de l'horloge système de l'ordinateur.Gets the millisecond count from the computer's system timer.

``````public:
property int TickCount { int get(); };``````
``public int TickCount { get; }``
``member this.TickCount : int``
``Public ReadOnly Property TickCount As Integer``

#### Valeur de propriété

`Integer` contenant le nombre de millisecondes de l'horloge système de l'ordinateur.An `Integer` containing the millisecond count from the computer's system timer.

## Exemples

L’exemple suivant utilise la `My.Computer.Clock.TickCount` propriété pour exécuter une tâche dans une boucle pendant un nombre donné de secondes, même si l’heure système de l’ordinateur change pendant son exécution.The following example uses the `My.Computer.Clock.TickCount` property to run a task in a loop for a given number of seconds, even if the computer's system time changes while it runs.

``````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
``````

## Remarques

La `TickCount` propriété permet d’accéder à la minuterie système de l’ordinateur, qui s’exécute lorsque l’ordinateur est actif.The `TickCount` property provides access to the computer's system timer, which runs when the computer is active. La résolution de la minuterie n’est pas inférieure à 500 millisecondes.The timer resolution is not less than 500 milliseconds.

Vous pouvez utiliser cette propriété pour que le comportement de votre application dépende de la durée d’exécution, ou vous pouvez l’utiliser pour étiqueter les événements, tous deux étant indépendants de l’horloge de l’ordinateur.You can use this property to make your application's behavior dependent on the length of time it has been running, or you can use it to label events, both of which are independent of the computer's clock.

Attention

Lorsque la valeur de la `TickCount` propriété atteint la valeur entière maximale (MaxValue), elle passe à la valeur entière minimale (MinValue), un nombre négatif et continue à s’incrémenter.When the value of the `TickCount` property reaches the maximum integer value (MaxValue), it then jumps to the minimum integer value (MinValue), a negative number, and continues to increment.

Si l’ordinateur s’exécute en `TickCount` continu, incrémente de zéro à la valeur entière maximale d’environ 24,9 jours.If the computer runs continuously, `TickCount` increments from zero to the maximum integer value in approximately 24.9 days.

La `TickCount` propriété est incrémentée uniquement lorsque le système d’exploitation est en cours d’exécution ; elle s’interrompt lorsque l’ordinateur passe à certains modes d’économie d’énergie, tels que la mise en veille ou la mise en veille prolongée.The `TickCount` property increments only when the operating system is running; it pauses when the computer goes into certain power-saving modes, such as standby or hibernation. La `TickCount` propriété n’est pas liée au paramètre de l’horloge de l’ordinateur.The `TickCount` property is unrelated to the computer's clock setting.

Utilisez la LocalTime propriété ou GmtTime la propriété pour obtenir la date et l’heure locales actuelles sur cet ordinateur.Use the LocalTime property or GmtTime property to obtain the current local date and time on this computer.

La `My.Computer.Clock.TickCount` propriété a le même comportement que la Environment.TickCount propriété.The `My.Computer.Clock.TickCount` property has the same behavior as the Environment.TickCount property.

### Disponibilité par type de projetAvailability by Project Type

Type de projetProject type DisponibleAvailable
Application WindowsWindows Application OuiYes
Bibliothèque de classesClass Library OuiYes
Application consoleConsole Application OuiYes
Bibliothèque de contrôles WindowsWindows Control Library OuiYes
Bibliothèque de contrôles WebWeb Control Library OuiYes
Service WindowsWindows Service OuiYes
Site webWeb Site OuiYes