Clock.TickCount プロパティ

.NET Framework クラス ライブラリ リファレンス

Clock.TickCount プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

コンピュータのシステム タイマに基づくミリ秒数を取得します。

名前空間: Microsoft.VisualBasic.Devices
アセンブリ: Microsoft.VisualBasic (microsoft.visualbasic.dll 内)
構文

Visual Basic (宣言)

Public ReadOnly Property
 TickCount As Integer

Visual Basic (使用法)

Dim instance As Clock
Dim value As Integer

value = instance.TickCount

C#

public int TickCount { get;
 }

C++

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

J#

/** @property */
public int get_TickCount ()

JScript

public function get TickCount
 () : int

プロパティ値
コンピュータのシステム タイマに基づくミリ秒数を保持する Integer。

解説

詳細については、Visual Basic のトピック「My.Computer.Clock.TickCount プロパティ」を参照してください。

TickCount プロパティを使用すると、コンピュータがアクティブになったときに実行されるシステム タイマにアクセスできます。タイマは 500 ミリ秒以上の解像力を備えています。

このプロパティを使用すると、コンピュータの時計が示す時刻ではなく、起動以降の経過時間によってアプリケーションの動作を変えたり、経過時間に基づいてイベントを識別したりできます。

注意
TickCount プロパティの値が整数の最大値 (MaxValue) に達すると、再び整数の最小値 (MinValue) に戻ってカウントを続行します。整数の最小値は負数になります。

コンピュータを終了せずに実行し続けた場合、TickCount はゼロから整数の最大値 (約 24.9 日) の範囲でインクリメントされます。

TickCount プロパティがインクリメントされるのは、オペレーティング システムが実行されている間だけです。コンピュータが省電力モード (スタンバイまたは休止状態など) に移行した場合、カウントは一時中断されます。TickCount プロパティは、コンピュータの時計設定とは関係ありません。

このコンピュータの現在のローカルな日付と時刻を取得するには、My.Computer.Clock.LocalTime プロパティ プロパティまたは My.Computer.Clock.GmtTime プロパティ プロパティを使用します。

My.Computer.Clock.TickCount プロパティと Environment.TickCount プロパティの動作は同じです。

使用例

次の例では、My.Computer.Clock.TickCount プロパティを使用して、指定された秒数だけタスクをループ処理します。実行中に、コンピュータのシステム時刻が変化しても、この動作には影響しません。

Visual Basic

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
Clock クラス
Clock メンバ
Microsoft.VisualBasic.Devices 名前空間
Environment.TickCount
Clock.TickCount プロパティ
その他の技術情報
My.Computer.Clock.TickCount プロパティ
My.Computer.Clock オブジェクト