Stopwatch.Frequency Campo

Definição

Namespace:

System.Diagnostics

Assembly:

System.Runtime.dll

Origem:

Stopwatch.cs

Obtém a frequência do temporizador como o número de tiques por segundo. Este campo é somente leitura.

public: static initonly long Frequency;

public static readonly long Frequency;

 staticval mutable Frequency : int64

Public Shared ReadOnly Frequency As Long 

Valor do campo

Int64

Exemplos

O exemplo a seguir exibe a frequência e a resolução de um Stopwatch temporizador. Este exemplo de código faz parte de um exemplo maior fornecido para a Stopwatch classe .

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

Comentários

A frequência do temporizador indica a precisão e a resolução do temporizador. Por exemplo, uma frequência de temporizador de 2 milhões de tiques por segundo é igual a uma resolução de temporizador de 500 nanossegundos por tique. Em outras palavras, como um segundo é igual a 1 bilhão de nanossegundos, uma frequência de temporizador de 2 milhões de tiques por segundo é equivalente a 2 milhões de tiques por 1 bilhão de nanossegundos, o que pode ser simplificado ainda mais para 1 tique por 500 nanossegundos.

O Frequency valor depende da resolução do mecanismo de tempo subjacente. Se o hardware instalado e o sistema operacional derem suporte a um contador de desempenho de alta resolução, o Frequency valor refletirá a frequência desse contador. Caso contrário, o Frequency valor é baseado na frequência do temporizador do sistema.

Como a Stopwatch frequência depende do hardware instalado e do sistema operacional, o Frequency valor permanece constante enquanto o sistema está em execução.

Confira também

• IsHighResolution