July 26, 2012
Provides a set of methods and properties that you can use to accurately measure elapsed time.
Assembly: Microsoft.Phone (in Microsoft.Phone.dll)
XMLNS for XAML: Not mapped to an xmlns.
Thetype exposes the following members.
|Elapsed||Gets the total elapsed time measured by the current instance.|
|ElapsedMilliseconds||Gets the total elapsed time measured by the current instance, in milliseconds.|
|ElapsedTicks||Gets the total elapsed time measured by the current instance, in timer ticks.|
|IsRunning||Gets a value indicating whether the Stopwatch timer is running.|
|Equals||(Inherited from Object.)|
|Finalize||(Inherited from Object.)|
|GetElapsedDateTimeTicks||Gets the number of ticks that represent the date and time of this instance.|
|GetHashCode||(Inherited from Object.)|
|GetRawElapsedTicks||Gets the total elapsed time measured by the current instance, in timer ticks.|
|GetTimestamp||Gets the current number of ticks in the timer mechanism.|
|GetType||(Inherited from Object.)|
|MemberwiseClone||(Inherited from Object.)|
|Reset||Stops time interval measurement and resets the elapsed time to zero.|
|Start||Starts, or resumes, measuring elapsed time for an interval.|
|StartNew||Initializes a new Stopwatch instance, sets the elapsed time property to zero, and starts measuring elapsed time.|
|Stop||Stops measuring elapsed time for an interval.|
|ToString||(Inherited from Object.)|
A Stopwatch instance can measure the elapsed time for one interval or the total amount of elapsed time across multiple intervals. In a typical Stopwatch scenario, you call the Start() method, then, eventually call the Stop() method, and then you check the elapsed time using the Elapsed property.
A Stopwatch instance is either running or stopped; use IsRunning to determine the current state of a Stopwatch. Use Start to begin measuring elapsed time; use Stop to stop measuring elapsed time. Query the elapsed time value through the properties Elapsed, ElapsedMilliseconds, or ElapsedTicks. You can query the elapsed time properties while the instance is running or stopped. The elapsed time properties steadily increase while the Stopwatch is running; they remain constant when the instance is stopped.
By default, the elapsed time value of a Stopwatch instance equals the total of all measured time intervals. 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. Use the Reset() method to clear the cumulative elapsed time in an existing Stopwatch instance.
The Stopwatch measures elapsed time by counting timer ticks in the underlying timer mechanism. If the installed hardware and operating system support a high-resolution performance counter, then the Stopwatch class uses that counter to measure elapsed time. Otherwise, the Stopwatch class uses the system timer to measure elapsed time. Use the Frequency and IsHighResolution fields to determine the precision and resolution of the Stopwatch timing implementation.
The Stopwatch class assists the manipulation of timing-related performance counters within managed code. Specifically, the Frequency field and GetTimestamp() method can be used in place of the unmanaged Win32 APIs QueryPerformanceFrequency and QueryPerformanceCounter.