語言

Stopwatch.Elapsed 屬性

定義

取得目前實例所測量的總經過時間。

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

屬性值

一個只讀 TimeSpan ,代表目前實例所測量的總經過時間。

範例

以下範例示範如何利用該 Elapsed 屬性來決定應用程式的執行時間。

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

備註

在典型 Stopwatch 情況下,你先呼叫該 Start 方法,然後最終呼叫該 Stop 方法,然後利用該 Elapsed 屬性檢查經過時間。

利用該 Elapsed 屬性來取得經過的時間值,並使用 TimeSpan 方法與屬性。 例如,你可以將回傳 TimeSpan 的實例格式化成文字表示,或傳給需要參數 TimeSpan 的另一個類別。

你可以查詢屬性 Elapsed、、 ElapsedMilliseconds以及 ElapsedTicks 當 Stopwatch 實例執行或停止時。 當實 Stopwatch 例執行時,經過時間的特性會逐漸增加;當實例停止時,這些特性保持不變。

預設情況下,實例經過的時間值 Stopwatch 等於所有測量時間區間的總和。 每次呼叫 從 Start 累積經過時間開始計數;每次呼叫 Stop 結束當前區間測量,並凍結累積經過時間值。 使用該 Reset 方法清除現有 Stopwatch 實例的累積經過時間。

適用於

另請參閱