Clock.TickCount Propriété

Définition

Espace de noms:

Microsoft.VisualBasic.Devices

Assembly:

Microsoft.VisualBasic.Forms.dll

Obtient le nombre de millisecondes de l'horloge système de l'ordinateur.

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

public int TickCount { get; }

member this.TickCount : int

Public ReadOnly Property TickCount As Integer

Valeur de propriété

Int32

Integer contenant le nombre de millisecondes de l'horloge système de l'ordinateur.

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.

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 au minuteur système de l’ordinateur, qui s’exécute lorsque l’ordinateur est actif. La résolution du minuteur n’est pas inférieure à 500 millisecondes.

Vous pouvez utiliser cette propriété pour rendre le comportement de votre application dépendant de la durée d’exécution de celle-ci, ou vous pouvez l’utiliser pour étiqueter des événements, qui sont tous deux indépendants de l’horloge de l’ordinateur.

Attention

Lorsque la valeur de la TickCount propriété atteint la valeur entière maximale (MaxValue), elle passe ensuite à la valeur entière minimale (MinValue), un nombre négatif, et continue à s’incrémenter.

Si l’ordinateur s’exécute en continu, TickCount incrémente de zéro à la valeur entière maximale dans environ 24,9 jours.

La TickCount propriété s’incrémente 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 veille ou la mise en veille prolongée. La TickCount propriété n’est pas liée au paramètre d’horloge de l’ordinateur.

Utilisez la LocalTime propriété ou GmtTime la propriété pour obtenir la date et l’heure locales actuelles sur cet ordinateur.

La My.Computer.Clock.TickCount propriété a le même comportement que la Environment.TickCount propriété .

Disponibilité par type de projet

Type de projet	Disponible
Application Windows	Oui
Bibliothèque de classes	Oui
Application console	Oui
Bibliothèque de contrôles Windows	Oui
Bibliothèque de contrôles web	Oui
Service Windows	Oui
Site web	Oui

Voir aussi

• TickCount
• Objets (Visual Basic)