Stopwatch.Frequency Feld

Definition

Ruft die Frequenz des Timers als Anzahl von Ticks pro Sekunde ab.Gets the frequency of the timer as the number of ticks per second. Dieses Feld ist schreibgeschützt.This field is read-only.

public: static initonly long Frequency;
public static readonly long Frequency;
 staticval mutable Frequency : int64
Public Shared ReadOnly Frequency As Long 

Feldwert

Int64

Beispiele

Im folgenden Beispiel wird die Häufigkeit und Auflösung eines Stopwatch Timers angezeigt.The following example displays the frequency and resolution of a Stopwatch timer. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die-Klasse bereitgestellt wird Stopwatch .This code example is part of a larger example provided for the Stopwatch class.

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}",
        frequency);
    long nanosecPerTick = (1000L*1000L*1000L) / frequency;
    Console.WriteLine("  Timer is accurate within {0} nanoseconds",
        nanosecPerTick);
}
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

Hinweise

Die Zeit Geber Frequenz gibt die Zeit Geber Genauigkeit und-Auflösung an.The timer frequency indicates the timer precision and resolution. Eine Zeit Geber Frequenz von 2 Millionen Ticks pro Sekunde ist beispielsweise eine Zeit Geber Auflösung von 500 Nanosekunden pro Tick.For example, a timer frequency of 2 million ticks per second equals a timer resolution of 500 nanoseconds per tick. Das heißt, weil eine Sekunde gleich 1 Milliarde Nanosekunden ist, entspricht eine Zeit Geber Häufigkeit von 2 Millionen Ticks pro Sekunde 2 Millionen Ticks pro 1 Milliarde nanoseconds. Dies kann zu einer weiteren Vereinfachung auf 1 Tick pro 500 nanoseconds werden.In other words, because one second equals 1 billion nanoseconds, a timer frequency of 2 million ticks per second is equivalent to 2 million ticks per 1 billion nanoseconds, which can be further simplified to 1 tick per 500 nanoseconds.

Der Frequency Wert hängt von der Auflösung des zugrunde liegenden Zeit Steuerungsmechanismus ab.The Frequency value depends on the resolution of the underlying timing mechanism. Wenn die installierte Hardware und das Betriebssystem einen Leistungs Bewert mit hoher Auflösung unterstützen, gibt der Frequency Wert die Häufigkeit des Leistungs Zählers an.If the installed hardware and operating system support a high-resolution performance counter, then the Frequency value reflects the frequency of that counter. Andernfalls basiert der Frequency Wert auf der Zeit Geber Frequenz des Systems.Otherwise, the Frequency value is based on the system timer frequency.

Da die Stopwatch Häufigkeit von der installierten Hardware und dem Betriebssystem abhängt, Frequency bleibt der Wert konstant, während das System ausgeführt wird.Because the Stopwatch frequency depends on the installed hardware and operating system, the Frequency value remains constant while the system is running.

Gilt für:

Siehe auch