Stopwatch.Elapsed プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

Stopwatch.Elapsed プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

現在のインスタンスで計測された経過時間の合計を取得します。

名前空間: System.Diagnostics
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public ReadOnly Property
 Elapsed As TimeSpan

Visual Basic (使用法)

Dim instance As Stopwatch
Dim value As TimeSpan

value = instance.Elapsed

public TimeSpan Elapsed { get; }

C++

public:
property TimeSpan Elapsed {
    TimeSpan get ();
}

/** @property */
public TimeSpan get_Elapsed ()

JScript

public function get Elapsed
 () : TimeSpan

プロパティ値
現在のインスタンスで計測された経過時間の合計を表す読み取り専用の TimeSpan。

解説

一般的な Stopwatch のシナリオでは、Start メソッドを呼び出してから、最終的に Stop メソッドを呼び出し、Elapsed プロパティを使用して経過時間を確認します。

TimeSpan のメソッドおよびプロパティを使用して経過時間の値を取得するには、Elapsed プロパティを使用します。たとえば、返された TimeSpan インスタンスをテキスト形式に書式設定したり、TimeSpan パラメータを必要とする別のクラスに渡したりできます。

Stopwatch インスタンスの実行中または停止中に、Elapsed、ElapsedMilliseconds、および ElapsedTicks の各プロパティを問い合わせることができます。経過時間のプロパティは、Stopwatch の実行中は徐々に増加し、インスタンスの停止中は変化しません。

既定では、Stopwatch インスタンスの経過時間の値は、計測されたすべての時間間隔の合計と等しくなります。Start を呼び出すたびに、累積経過時間のカウントが開始されます。Stop を呼び出すたびに、現在の間隔計測を終了して、累積経過時間の値を固定します。既存の Stopwatch インスタンスの累積経過時間を消去するには、Reset メソッドを使用します。

使用例

Stopwatch インスタンスの経過時間を取得して、値をテキスト形式に書式設定する例を次に示します。このコード例は、Stopwatch クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

' Get the elapsed time as a TimeSpan value.
Dim ts As TimeSpan = stopWatch.Elapsed

' Format and display the TimeSpan value.
labelTime.Text = String.Format("{0:00}:{1:00}:{2:00}.{3:00}",
 _
    ts.Hours, ts.Minutes, ts.Seconds, ts.Milliseconds/10)

// Get the elapsed time as a TimeSpan value.
TimeSpan ts = stopWatch.Elapsed;

// Format and display the TimeSpan value.
labelTime.Text = String.Format("{0:00}:{1:00}:{2:00}.{3:00}", 
    ts.Hours, ts.Minutes, ts.Seconds, 
    ts.Milliseconds/10);

C++

// Get the elapsed time as a TimeSpan value.
TimeSpan ts = stopWatch->Elapsed;

// Format and display the TimeSpan value.
labelTime->Text = String::Format( "{0:00}:{1:00}:{2:00}.{3:00}", ts.Hours,
 ts.Minutes, ts.Seconds, ts.Milliseconds / 10 );

// Get the elapsed time as a TimeSpan value.
TimeSpan ts = stopWatch.get_Elapsed();
// Format and display the TimeSpan value.
labelTime.set_Text(((System.Int32)ts.get_Hours()).ToString("00") 
    + ":" + ((System.Int32)ts.get_Minutes()).ToString("00") 
    + ":" + ((System.Int32)ts.get_Seconds()).ToString("00") 
    + "." + ((System.Int32)(ts.get_Milliseconds() / 10)).
    ToString("00"));