Stopwatch.Frequency フィールドとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

Stopwatch.Frequency フィールド

メモ : このフィールドは、.NET Framework version 2.0 で新しく追加されたものです。

1 秒あたりのタイマ刻みの数として、タイマの頻度を取得します。このフィールドは読み取り専用です。

名前空間: System.Diagnostics
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Shared ReadOnly Frequency
 As Long

Visual Basic (使用法)

Dim value As Long

value = Stopwatch.Frequency

public static readonly long Frequency

C++

public:
static initonly long long Frequency

public static final long Frequency

JScript

public static final var
 Frequency : long

解説

タイマ頻度は、タイマの精度と解像力を示します。たとえば、毎秒 200 万のタイマ刻みのタイマ頻度は、タイマ刻みあたり 500 ナノ秒のタイマ解像力と等価です。つまり、1 秒は 10 億ナノ秒と等しいため、毎秒 200 万のタイマ刻みのタイマ頻度は、10 億ナノ秒あたり 200 万のタイマ刻みと等しくなります。これをさらに簡略化すると、500 ナノ秒あたり 1 タイマ刻みになります。

Frequency 値は、基になるタイミング機構の解像力によって異なります。インストールされているハードウェアおよびオペレーティングシステムが高解像力のパフォーマンスカウンタをサポートする場合、Frequency 値はそのカウンタの頻度を反映します。それ以外の場合、Frequency 値はシステムタイマ頻度に基づきます。

Stopwatch 頻度は、インストールされているハードウェアおよびオペレーティングシステムによって異なるため、Frequency 値はシステムの実行中は変化しません。

使用例

Stopwatch クラスの頻度および解像力を表示する例を次に示します。

Visual Basic

Public Shared Sub DisplayTimerProperties()

   ' Display the timer frequency and resolution.
   If Stopwatch.IsHighResolution Then
      Console.WriteLine("Operations timed using the system's high-resolution
 performance counter.")
   Else
      Console.WriteLine("Operations timed using the DateTime class.")
   End If
   
   Dim frequency As Long
 = Stopwatch.Frequency
   Console.WriteLine("  Timer frequency in ticks per second =
 {0}", frequency)
   Dim nanosecPerTick As Long
 = 1000000000 / frequency
   Console.WriteLine("  Timer is accurate within {0} nanoseconds",
 nanosecPerTick)

End Sub

public static void DisplayTimerProperties()
{
    // Display the timer frequency and resolution.
    if (Stopwatch.IsHighResolution)
    {
        Console.WriteLine("Operations timed using the system's
 high-resolution performance counter.");
    }
    else 
    {
        Console.WriteLine("Operations timed using the DateTime
 class.");
    }

    long frequency = Stopwatch.Frequency;
    Console.WriteLine("  Timer frequency in ticks per second
 = {0}",
        frequency);
    long nanosecPerTick = (1000L*1000L*1000L) / frequency;
    Console.WriteLine("  Timer is accurate within {0} nanoseconds", 
        nanosecPerTick);
}

C++

void DisplayTimerProperties()
{
   // Display the timer frequency and resolution.
   if ( Stopwatch::IsHighResolution )
   {
      Console::WriteLine( "Operations timed using the system's
 high-resolution performance counter." );
   }
   else
   {
      Console::WriteLine( "Operations timed using the DateTime
 class." );
   }

   Int64 frequency = Stopwatch::Frequency;
   Console::WriteLine( "  Timer frequency in ticks per second
 = {0}", frequency );
   Int64 nanosecPerTick = (1000L * 1000L * 1000L) / frequency;
   Console::WriteLine( "  Timer is accurate within {0} nanoseconds", nanosecPerTick
 );
}

public static void DisplayTimerProperties()
{
    // Display the timer frequency and resolution.
    if (Stopwatch.IsHighResolution) {
        Console.WriteLine("Operations timed using the system's
 "
            + "high-resolution performance counter.");
    }
    else {
        Console.WriteLine("Operations timed using the DateTime
 class.");
    }

    long frequency = Stopwatch.Frequency;
    Console.WriteLine("  Timer frequency in ticks per second
 = {0}", 
        (Int64)frequency);
    long nanoSecPerTick = (1000L * 1000L * 1000L) / frequency;
    Console.WriteLine("  Timer is accurate within {0} nanoseconds", 
        (Int64)nanoSecPerTick);
} //DisplayTimerProperties