Stopwatch.ElapsedMilliseconds Propriedade

Definição

Obtém o tempo decorrido total medido pela instância atual, em milissegundos.

public:
 property long ElapsedMilliseconds { long get(); };
public long ElapsedMilliseconds { get; }
member this.ElapsedMilliseconds : int64
Public ReadOnly Property ElapsedMilliseconds As Long

Valor da propriedade

Um inteiro longo somente leitura que representa o número total de milissegundos medido pela instância atual.

Exemplos

O exemplo a seguir usa a Stopwatch classe para medir o desempenho de quatro implementações diferentes para analisar um inteiro de uma cadeia de caracteres. Este exemplo de código faz parte de um exemplo maior fornecido para a Stopwatch classe.

private static void TimeOperations()
{
    long nanosecPerTick = (1000L*1000L*1000L) / Stopwatch.Frequency;
    const long numIterations = 10000;

    // Define the operation title names.
    String [] operationNames = {"Operation: Int32.Parse(\"0\")",
                                   "Operation: Int32.TryParse(\"0\")",
                                   "Operation: Int32.Parse(\"a\")",
                                   "Operation: Int32.TryParse(\"a\")"};

    // Time four different implementations for parsing
    // an integer from a string.

    for (int operation = 0; operation <= 3; operation++)
    {
        // Define variables for operation statistics.
        long numTicks = 0;
        long numRollovers = 0;
        long maxTicks = 0;
        long minTicks = Int64.MaxValue;
        int indexFastest = -1;
        int indexSlowest = -1;
        long milliSec = 0;

        Stopwatch time10kOperations = Stopwatch.StartNew();

        // Run the current operation 10001 times.
        // The first execution time will be tossed
        // out, since it can skew the average time.

        for (int i=0; i<=numIterations; i++)
        {
            long ticksThisTime = 0;
            int inputNum;
            Stopwatch timePerParse;

            switch (operation)
            {
                case 0:
                    // Parse a valid integer using
                    // a try-catch statement.

                    // Start a new stopwatch timer.
                    timePerParse = Stopwatch.StartNew();

                    try
                    {
                        inputNum = Int32.Parse("0");
                    }
                    catch (FormatException)
                    {
                        inputNum = 0;
                    }

                    // Stop the timer, and save the
                    // elapsed ticks for the operation.

                    timePerParse.Stop();
                    ticksThisTime = timePerParse.ElapsedTicks;
                    break;
                case 1:
                    // Parse a valid integer using
                    // the TryParse statement.

                    // Start a new stopwatch timer.
                    timePerParse = Stopwatch.StartNew();

                    if (!Int32.TryParse("0", out inputNum))
                    {
                        inputNum = 0;
                    }

                    // Stop the timer, and save the
                    // elapsed ticks for the operation.
                    timePerParse.Stop();
                    ticksThisTime = timePerParse.ElapsedTicks;
                    break;
                case 2:
                    // Parse an invalid value using
                    // a try-catch statement.

                    // Start a new stopwatch timer.
                    timePerParse = Stopwatch.StartNew();

                    try
                    {
                        inputNum = Int32.Parse("a");
                    }
                    catch (FormatException)
                    {
                        inputNum = 0;
                    }

                    // Stop the timer, and save the
                    // elapsed ticks for the operation.
                    timePerParse.Stop();
                    ticksThisTime = timePerParse.ElapsedTicks;
                    break;
                case 3:
                    // Parse an invalid value using
                    // the TryParse statement.

                    // Start a new stopwatch timer.
                    timePerParse = Stopwatch.StartNew();

                    if (!Int32.TryParse("a", out inputNum))
                    {
                        inputNum = 0;
                    }

                    // Stop the timer, and save the
                    // elapsed ticks for the operation.
                    timePerParse.Stop();
                    ticksThisTime = timePerParse.ElapsedTicks;
                    break;

                default:
                    break;
            }

            // Skip over the time for the first operation,
            // just in case it caused a one-time
            // performance hit.
            if (i == 0)
            {
                time10kOperations.Reset();
                time10kOperations.Start();
            }
            else
            {

                // Update operation statistics
                // for iterations 1-10000.
                if (maxTicks < ticksThisTime)
                {
                    indexSlowest = i;
                    maxTicks = ticksThisTime;
                }
                if (minTicks > ticksThisTime)
                {
                    indexFastest = i;
                    minTicks = ticksThisTime;
                }
                numTicks += ticksThisTime;
                if (numTicks < ticksThisTime)
                {
                    // Keep track of rollovers.
                    numRollovers ++;
                }
            }
        }

        // Display the statistics for 10000 iterations.

        time10kOperations.Stop();
        milliSec = time10kOperations.ElapsedMilliseconds;

        Console.WriteLine();
        Console.WriteLine("{0} Summary:", operationNames[operation]);
        Console.WriteLine("  Slowest time:  #{0}/{1} = {2} ticks",
            indexSlowest, numIterations, maxTicks);
        Console.WriteLine("  Fastest time:  #{0}/{1} = {2} ticks",
            indexFastest, numIterations, minTicks);
        Console.WriteLine("  Average time:  {0} ticks = {1} nanoseconds",
            numTicks / numIterations,
            (numTicks * nanosecPerTick) / numIterations );
        Console.WriteLine("  Total time looping through {0} operations: {1} milliseconds",
            numIterations, milliSec);
    }
}
Private Shared Sub TimeOperations()

   Dim nanosecPerTick As Long = 1000000000 / Stopwatch.Frequency
   Const numIterations As Long = 10000

   ' Define the operation title names.
   Dim operationNames As String() =  _
     {"Operation: Int32.Parse(""0"")", _
      "Operation: Int32.TryParse(""0"")", _
      "Operation: Int32.Parse(""a"")", _
      "Operation: Int32.TryParse(""a"")"}

   ' Time four different implementations for parsing
   ' an integer from a string.

   Dim operation As Integer
   For operation = 0 To 3
      ' Define variables for operation statistics.
      Dim numTicks As Long = 0
      Dim numRollovers As Long = 0
      Dim maxTicks As Long = 0
      Dim minTicks As Long = Int64.MaxValue
      Dim indexFastest As Integer = - 1
      Dim indexSlowest As Integer = - 1
      Dim milliSec As Long = 0

      Dim time10kOperations As Stopwatch = Stopwatch.StartNew()

      ' Run the current operation 10001 times.
      ' The first execution time will be tossed
      ' out, since it can skew the average time.
      Dim i As Integer
      For i = 0 To numIterations
         Dim ticksThisTime As Long = 0
         Dim inputNum As Integer
         Dim timePerParse As Stopwatch

         Select Case operation
            Case 0
               ' Parse a valid integer using
               ' a try-catch statement.
               ' Start a new stopwatch timer.
               timePerParse = Stopwatch.StartNew()

               Try
                  inputNum = Int32.Parse("0")
               Catch e As FormatException
                  inputNum = 0
               End Try

               ' Stop the timer, and save the
               ' elapsed ticks for the operation.
               timePerParse.Stop()
               ticksThisTime = timePerParse.ElapsedTicks
            Case 1
               ' Parse a valid integer using
               ' the TryParse statement.
               ' Start a new stopwatch timer.
               timePerParse = Stopwatch.StartNew()

               If Not Int32.TryParse("0", inputNum) Then
                  inputNum = 0
               End If

               ' Stop the timer, and save the
               ' elapsed ticks for the operation.
               timePerParse.Stop()
               ticksThisTime = timePerParse.ElapsedTicks
            Case 2
               ' Parse an invalid value using
               ' a try-catch statement.
               ' Start a new stopwatch timer.
               timePerParse = Stopwatch.StartNew()

               Try
                  inputNum = Int32.Parse("a")
               Catch e As FormatException
                  inputNum = 0
               End Try

               ' Stop the timer, and save the
               ' elapsed ticks for the operation.
               timePerParse.Stop()
               ticksThisTime = timePerParse.ElapsedTicks
            Case 3
               ' Parse an invalid value using
               ' the TryParse statement.
               ' Start a new stopwatch timer.
               timePerParse = Stopwatch.StartNew()

               If Not Int32.TryParse("a", inputNum) Then
                  inputNum = 0
               End If

               ' Stop the timer, and save the
               ' elapsed ticks for the operation.
               timePerParse.Stop()
               ticksThisTime = timePerParse.ElapsedTicks

            Case Else
         End Select

         ' Skip over the time for the first operation,
         ' just in case it caused a one-time
         ' performance hit.
         If i = 0 Then
            time10kOperations.Reset()
            time10kOperations.Start()
         Else

            ' Update operation statistics
            ' for iterations 1-10001.
            If maxTicks < ticksThisTime Then
               indexSlowest = i
               maxTicks = ticksThisTime
            End If
            If minTicks > ticksThisTime Then
               indexFastest = i
               minTicks = ticksThisTime
            End If
            numTicks += ticksThisTime
            If numTicks < ticksThisTime Then
               ' Keep track of rollovers.
               numRollovers += 1
            End If
         End If
      Next i

      ' Display the statistics for 10000 iterations.
      time10kOperations.Stop()
      milliSec = time10kOperations.ElapsedMilliseconds

      Console.WriteLine()
      Console.WriteLine("{0} Summary:", operationNames(operation))
      Console.WriteLine("  Slowest time:  #{0}/{1} = {2} ticks", _
         indexSlowest, numIterations, maxTicks)
      Console.WriteLine("  Fastest time:  #{0}/{1} = {2} ticks", _
         indexFastest, numIterations, minTicks)
      Console.WriteLine("  Average time:  {0} ticks = {1} nanoseconds", _
         numTicks / numIterations, numTicks * nanosecPerTick / numIterations)
      Console.WriteLine("  Total time looping through {0} operations: {1} milliseconds", _
         numIterations, milliSec)
   Next operation

End Sub

Comentários

Essa propriedade representa o tempo decorrido arredondado para baixo até o valor inteiro mais próximo de milissegundos. Para medidas de precisão mais altas, use as propriedades ou ElapsedTicks as Elapsed propriedades.

Você pode consultar as propriedades ElapsedeElapsedMilliseconds, ElapsedTicksenquanto a Stopwatch instância estiver em execução ou interrompida. As propriedades de tempo decorrido aumentam constantemente durante a execução Stopwatch ; elas permanecem constantes quando a instância é interrompida.

Por padrão, o valor de tempo decorrido de uma Stopwatch instância é igual ao total de todos os intervalos de tempo medidos. Cada chamada para começar a Start contar no tempo decorrido cumulativo; cada chamada para Stop encerrar a medida do intervalo atual e congela o valor de tempo decorrido cumulativo. Use o Reset método para limpar o tempo decorrido cumulativo em uma instância existente Stopwatch .

Aplica-se a

Confira também