Clock.TickCount Eigenschaft

Referenz

Definition

Namespace:: Microsoft.VisualBasic.Devices

Assembly:: Microsoft.VisualBasic.dll

Assembly:: Microsoft.VisualBasic.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft die Anzahl der Millisekunden vom Systemzeitgeber des Computers ab.

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

public int TickCount { get; }

member this.TickCount : int

Public ReadOnly Property TickCount As Integer

Eigenschaftswert

Int32

Ein Integer, der die Anzahl der Millisekunden vom Systemzeitgeber des Computers enthält.

Beispiele

Im folgenden Beispiel wird die My.Computer.Clock.TickCount -Eigenschaft verwendet, um eine Aufgabe in einer Schleife für eine bestimmte Anzahl von Sekunden auszuführen, auch wenn sich die Systemzeit des Computers während der Ausführung ändert.

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

Hinweise

Die TickCount -Eigenschaft ermöglicht den Zugriff auf den Systemtimer des Computers, der ausgeführt wird, wenn der Computer aktiv ist. Die Timerauflösung beträgt nicht weniger als 500 Millisekunden.

Sie können diese Eigenschaft verwenden, um das Verhalten Ihrer Anwendung von der Dauer der Ausführung abhängig zu machen, oder Sie können sie verwenden, um Ereignisse zu bezeichnen, die beide unabhängig von der Uhr des Computers sind.

Achtung

Wenn der Wert der TickCount -Eigenschaft den maximalen ganzzahligen Wert (MaxValue) erreicht, springt er auf den minimalen ganzzahligen Wert (MinValue), eine negative Zahl, und wird weiter inkrementiert.

Wenn der Computer kontinuierlich ausgeführt wird, TickCount erhöht sich in etwa 24,9 Tagen von null auf den maximalen ganzzahligen Wert.

Die TickCount Eigenschaft erhöht sich nur, wenn das Betriebssystem ausgeführt wird. Sie wird angehalten, wenn der Computer in bestimmte Energiesparmodi wechselt, z. B. Standby oder Ruhezustand. Die TickCount -Eigenschaft steht in keinem Zusammenhang mit der Uhreinstellung des Computers.

Verwenden Sie die LocalTime -Eigenschaft oder GmtTime -Eigenschaft, um das aktuelle lokale Datum und die aktuelle lokale Uhrzeit auf diesem Computer abzurufen.

Die My.Computer.Clock.TickCount -Eigenschaft hat das gleiche Verhalten wie die Environment.TickCount -Eigenschaft.

Verfügbarkeit nach Projekttyp

Projekttyp	Verfügbar
Windows-Anwendung	Ja
Klassenbibliothek	Ja
Konsolenanwendung	Ja
Windows-Steuerelementbibliothek	Ja
Websteuerelementbibliothek	Ja
Windows-Dienst	Ja
Website	Ja

Gilt für:

Freigeben über