Stopwatch.ElapsedTicks プロパティ

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

Stopwatch.ElapsedTicks プロパティ

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

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

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

Visual Basic (宣言)

Public ReadOnly Property
 ElapsedTicks As Long

Visual Basic (使用法)

Dim instance As Stopwatch
Dim value As Long

value = instance.ElapsedTicks

C#

public long ElapsedTicks { get; }

C++

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

J#

/** @property */
public long get_ElapsedTicks ()

JScript

public function get ElapsedTicks
 () : long

プロパティ値
現在のインスタンスで計測されたタイマ刻みの合計を表す読み取り専用の長整数。

解説

このプロパティは、基になるタイマ機構の経過したタイマ刻みの数を表します。タイマ刻みは、Stopwatch タイマが計測できる最小の時間単位です。ElapsedTicks 値を秒数に変換するには、Frequency フィールドを使用します。

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

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

メモ
Stopwatch タイマ刻みは、DateTime.Ticks とは異なります。DateTime.Ticks 値の各タイマ刻みは、100 ナノ秒間隔を表します。ElapsedTicks 値の各タイマ刻みは、1 秒を Frequency で割った値に等しい時間間隔を表します。

使用例

Stopwatch クラスを使用して、文字列から整数を解析するための 4 種類の実装のパフォーマンスを計測する例を次に示します。

Visual Basic

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

C#

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

C++

Int64 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", 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", inputNum ) )
      {
         inputNum = 0;
      }
      
      // Stop the timer, and save the
      // elapsed ticks for the operation.
      timePerParse->Stop();
      ticksThisTime = timePerParse->ElapsedTicks;
      break;

   default:
      break;
}

J#

long ticksThisTime = 0;
int inputNum = 0;
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 exp) {
            inputNum = 0;
        }
        // Stop the timer, and save the
        // elapsed ticks for the operation.
        timePerParse.Stop();
        ticksThisTime = timePerParse.get_ElapsedTicks();
        break;

    case 1:
        // Parse a valid integer using
        // the TryParse statement.
        // Start a new stopwatch timer.
        timePerParse = Stopwatch.StartNew();

        if (!(Int32.TryParse("0", inputNum))) {
            inputNum = 0;
        }
        // Stop the timer, and save the
        // elapsed ticks for the operation.
        timePerParse.Stop();
        ticksThisTime = timePerParse.get_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 exp) {
            inputNum = 0;
        }
        // Stop the timer, and save the
        // elapsed ticks for the operation.
        timePerParse.Stop();
        ticksThisTime = timePerParse.get_ElapsedTicks();
        break;

    case 3:
        // Parse an invalid value using
        // the TryParse statement.
        // Start a new stopwatch timer.
        timePerParse = Stopwatch.StartNew();

        if (!(Int32.TryParse("a", inputNum))) {
            inputNum = 0;
        }
        // Stop the timer, and save the
        // elapsed ticks for the operation.
        timePerParse.Stop();
        ticksThisTime = timePerParse.get_ElapsedTicks();
        break;

    default:
        break;
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
Stopwatch クラス
Stopwatch メンバ
System.Diagnostics 名前空間
Stopwatch.Elapsed プロパティ
Stopwatch.ElapsedMilliseconds プロパティ
Frequency