Stopwatch.Elapsed Eigenschaft

Definition

Ruft die gesamte verstrichene Zeit ab, die von der aktuellen Instanz gemessen wurde.Gets the total elapsed time measured by the current instance.

public:
 property TimeSpan Elapsed { TimeSpan get(); };
public TimeSpan Elapsed { get; }
member this.Elapsed : TimeSpan
Public ReadOnly Property Elapsed As TimeSpan

Eigenschaftswert

Eine schreibgeschützte TimeSpan, die die gesamte, von der aktuellen Instanz gemessene verstrichene Zeit darstellt.A read-only TimeSpan representing the total elapsed time measured by the current instance.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die Elapsed-Eigenschaft verwendet wird, um die Ausführungszeit für eine Anwendung zu bestimmen.The following example demonstrates how to use the Elapsed property to determine the execution time for an application.

using System;
using System.Diagnostics;
using System.Threading;
class Program
{
    static void Main(string[] args)
    {
        Stopwatch stopWatch = new Stopwatch();
        stopWatch.Start();
        Thread.Sleep(10000);
        stopWatch.Stop();
        // Get the elapsed time as a TimeSpan value.
        TimeSpan ts = stopWatch.Elapsed;

        // Format and display the TimeSpan value.
        string elapsedTime = String.Format("{0:00}:{1:00}:{2:00}.{3:00}",
            ts.Hours, ts.Minutes, ts.Seconds,
            ts.Milliseconds / 10);
        Console.WriteLine("RunTime " + elapsedTime);
    }
}
Imports System.Diagnostics
Imports System.Threading


Class Program

    Shared Sub Main(ByVal args() As String)
        Dim stopWatch As New Stopwatch()
        stopWatch.Start()
        Thread.Sleep(10000)
        stopWatch.Stop()
        ' Get the elapsed time as a TimeSpan value.
        Dim ts As TimeSpan = stopWatch.Elapsed

        ' Format and display the TimeSpan value.
        Dim elapsedTime As String = String.Format("{0:00}:{1:00}:{2:00}.{3:00}", ts.Hours, ts.Minutes, ts.Seconds, ts.Milliseconds / 10)
        Console.WriteLine( "RunTime " + elapsedTime)

    End Sub
End Class

Hinweise

In einem typischen Stopwatch Szenario wird die Start-Methode aufgerufen, schließlich wird die Stop-Methode aufgerufen, und anschließend wird die verstrichene Zeit mithilfe der Elapsed-Eigenschaft überprüft.In a typical Stopwatch scenario, you call the Start method, then eventually call the Stop method, and then you check elapsed time using the Elapsed property.

Verwenden Sie die Elapsed-Eigenschaft, um den Wert für die verstrichene Zeit mithilfe TimeSpan Methoden und Eigenschaften abzurufen.Use the Elapsed property to retrieve the elapsed time value using TimeSpan methods and properties. Beispielsweise können Sie die zurückgegebene TimeSpan Instanz in eine Textdarstellung formatieren oder an eine andere Klasse übergeben, die einen TimeSpan-Parameter erfordert.For example, you can format the returned TimeSpan instance into a text representation, or pass it to another class that requires a TimeSpan parameter.

Sie können die Eigenschaften Elapsed, ElapsedMillisecondsund ElapsedTicks Abfragen, während die Stopwatch Instanz ausgeführt oder beendet wird.You can query the properties Elapsed, ElapsedMilliseconds, and ElapsedTicks while the Stopwatch instance is running or stopped. Die verstrichenen Zeit werden während der Ausführung der Stopwatch konstant erhöht. Sie bleiben konstant, wenn die Instanz beendet wird.The elapsed time properties steadily increase while the Stopwatch is running; they remain constant when the instance is stopped.

Standardmäßig ist der verstrichene Zeitwert einer Stopwatch Instanz gleich der Summe aller gemessenen Zeitintervalle.By default, the elapsed time value of a Stopwatch instance equals the total of all measured time intervals. Jeder Aufruf von Start beginnt mit der Zählung der kumulativen verstrichenen Zeit. Jeder Aufruf von Stop beendet die aktuelle Intervallmessung und friert den kumulativen Wert für die verstrichene Zeit ein.Each call to Start begins counting at the cumulative elapsed time; each call to Stop ends the current interval measurement and freezes the cumulative elapsed time value. Verwenden Sie die Reset-Methode, um die kumulierte verstrichene Zeit in einer vorhandenen Stopwatch Instanz zu löschen.Use the Reset method to clear the cumulative elapsed time in an existing Stopwatch instance.

Gilt für:

Siehe auch