Stopwatch.ElapsedTicks プロパティ

定義

名前空間:

System.Diagnostics

アセンブリ:

System.dll

現在のインスタンスによって測定された合計経過時間をタイマー ティック単位で取得します。

public:
 property long ElapsedTicks { long get(); };

public long ElapsedTicks { get; }

member this.ElapsedTicks : int64

Public ReadOnly Property ElapsedTicks As Long

プロパティ値

Int64

現在のインスタンスによって測定されたタイマー ティックの合計数を表す読み取り専用の長整数。

例

次の例では、 Stopwatch クラスを使用して、文字列から整数を解析するための 4 つの異なる実装のパフォーマンスを測定します。 このコード例は、 Stopwatch クラスに提供されるより大きな例の一部です。

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;
}

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

注釈

このプロパティは、基になるタイマー メカニズムの経過ティック数を表します。 ティックは、 Stopwatch タイマーが測定できる最小時間単位です。 Frequency フィールドを使用して、ElapsedTicks値を秒数に変換します。

Elapsed インスタンスの実行中または停止中に、プロパティ ElapsedMilliseconds、ElapsedTicks、およびStopwatchに対してクエリを実行できます。 経過時間プロパティは、 Stopwatch の実行中に着実に増加します。インスタンスが停止しても一定のままです。

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

Note

Stopwatch ティックは DateTime.Ticksとは異なります。 DateTime.Ticks値の各ティックは、100 ナノ秒間隔を表します。 ElapsedTicks値の各ティックは、1 秒をFrequencyで除算した時間間隔を表します。

こちらもご覧ください

• Elapsed
• ElapsedMilliseconds
• Frequency