Clock.TickCount Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene el recuento al milisegundo del temporizador del sistema del equipo.
public:
property int TickCount { int get(); };
public int TickCount { get; }
member this.TickCount : int
Public ReadOnly Property TickCount As Integer
Valor de propiedad
Un valor de tipo Integer
que contiene el recuento al milisegundo del temporizador del sistema del equipo.
Ejemplos
En el ejemplo siguiente se usa la My.Computer.Clock.TickCount
propiedad para ejecutar una tarea en un bucle durante un número determinado de segundos, incluso si la hora del sistema del equipo cambia mientras se ejecuta.
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
Comentarios
La TickCount
propiedad proporciona acceso al temporizador del sistema del equipo, que se ejecuta cuando el equipo está activo. La resolución del temporizador no es inferior a 500 milisegundos.
Puede usar esta propiedad para que el comportamiento de la aplicación dependa del período de tiempo que se ha estado ejecutando, o puede usarlo para etiquetar eventos, ambos independientes del reloj del equipo.
Precaución
Cuando el valor de la TickCount
propiedad alcanza el valor entero máximo (MaxValue), se salta al valor entero mínimo (MinValue), un número negativo y continúa incrementándose.
Si el equipo se ejecuta continuamente, TickCount
se incrementa de cero al valor entero máximo en aproximadamente 24,9 días.
La TickCount
propiedad solo se incrementa cuando el sistema operativo se está ejecutando; se detiene cuando el equipo entra en determinados modos de ahorro de energía, como modo de espera o hibernación. La TickCount
propiedad no está relacionada con la configuración del reloj del equipo.
Utilice la LocalTime propiedad o GmtTime la propiedad para obtener la fecha y hora locales actuales en este equipo.
La My.Computer.Clock.TickCount
propiedad tiene el mismo comportamiento que la Environment.TickCount propiedad .
Disponibilidad por tipo de proyecto
Tipo de proyecto | Disponible |
---|---|
Aplicación Windows | Sí |
Biblioteca de clases | Sí |
Aplicación de consola | Sí |
Biblioteca de controles de Windows | Sí |
Biblioteca de controles web | Sí |
Servicio de Windows | Sí |
Sitio web | Sí |