C# Stopwatch 程序性能测量

1.定义

Stopwatch 可以测量一个时间间隔的运行时间，也可以测量多个时间间隔的总运行时间。一般用来测量代码执行所用的时间或者计算性能数据，在优化代码性能上可以使用Stopwatch来测量时间。

2.API

namespace System.Diagnostics  
{  
    //  
    // 摘要:  
    //     提供一组方法和属性，可用于准确地测量运行时间。  
    public class Stopwatch  
    {  
        //  
        // 摘要:  
        //     获取以每秒计时周期数表示的计时器频率。此字段为只读。  
        public static readonly long Frequency;  
        //  
        // 摘要:  
        //     指示计时器是否基于高分辨率性能计数器。此字段为只读。  
        public static readonly bool IsHighResolution;  
  
        //  
        // 摘要:  
        //     初始化 System.Diagnostics.Stopwatch 类的新实例。  
        public Stopwatch();  
  
        //  
        // 摘要:  
        //     获取当前实例测量得出的总运行时间。  
        //  
        // 返回结果:  
        //     一个只读的 System.TimeSpan，用于表示当前实例测量得出的总运行时间。  
        public TimeSpan Elapsed { get; }  
        //  
        // 摘要:  
        //     获取当前实例测量得出的总运行时间（以毫秒为单位）。  
        //  
        // 返回结果:  
        //     一个只读长整型，表示当前实例测量得出的总毫秒数。  
        public long ElapsedMilliseconds { get; }  
        //  
        // 摘要:  
        //     获取当前实例测量得出的总运行时间（用计时器计时周期表示）。  
        //  
        // 返回结果:  
        //     一个只读长整型，表示当前实例测量得出的计时器计时周期的总数。  
        public long ElapsedTicks { get; }  
        //  
        // 摘要:  
        //     获取一个指示 System.Diagnostics.Stopwatch 计时器是否在运行的值。  
        //  
        // 返回结果:  
        //     如果 System.Diagnostics.Stopwatch 实例当前正在运行，并且在对某个时间间隔的运行时间进行测量，则该值为 true；否则为 false。  
        public bool IsRunning { get; }  
  
        //  
        // 摘要:  
        //     获取计时器机制中的当前最小时间单位数。  
        //  
        // 返回结果:  
        //     一个长整型，表示基础计时器机制中的计时周期计数器值。  
        public static long GetTimestamp();  
        //  
        // 摘要:  
        //     对新的 System.Diagnostics.Stopwatch 实例进行初始化，将运行时间属性设置为零，然后开始测量运行时间。  
        //  
        // 返回结果:  
        //     刚刚开始测量运行时间的 System.Diagnostics.Stopwatch。  
        public static Stopwatch StartNew();  
        //  
        // 摘要:  
        //     停止时间间隔测量，并将运行时间重置为零。  
        public void Reset();  
        //  
        // 摘要:  
        //     停止时间间隔测量，将运行时间重置为零，然后开始测量运行时间。  
        public void Restart();  
        //  
        // 摘要:  
        //     开始或继续测量某个时间间隔的运行时间。  
        public void Start();  
        //  
        // 摘要:  
        //     停止测量某个时间间隔的运行时间。  
        public void Stop();  
    }  
}

3.使用示例

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Diagnostics;

namespace BoxAndUnBox
{
    class Program
    {
        static void Main(string[] args)
        {
            Stopwatch watch = new Stopwatch();
            watch.Start();
            long result = SumWithoutBox();
            watch.Stop();
            Console.WriteLine("SumWithoutBox()方法返回计算结果：{0}，用时{1}毫秒",
               result, watch.ElapsedMilliseconds);//获取当前实例测量得出的总运行时间（以毫秒为单位）
            watch.Restart();
            result = SumWithBox();
            watch.Stop();
            Console.WriteLine("SumWithBox()方法返回计算结果：{0}，用时{1}毫秒",
         result, watch.ElapsedMilliseconds);
            Console.ReadKey();
        }

        static long SumWithoutBox()
        {
            long sum = 0;
            for (long i = 0; i < 10000000; i++)
                sum += i;
            return sum;
        }

        static long SumWithBox()
        {
            object sum = 0L; //装箱
            for (long i = 0; i < 10000000; i++)
                sum = (long)sum + i;//先拆箱,求和，再装箱
            return (long)sum;//拆箱
        }
    }
}