一个Excel导出类的实现过程（四）：格式化与若干坑 已补图和代码zip

这是本文的第四部分也是最后部分，适合新人初步学习泛型、反射，提供了有限的业务场景分析、若干的NPOI接口使用示范，前三部分链接如下：

• 一个Excel导出类的实现过程（一）：泛型与反射
• 一个Excel导出类的实现过程（二）：显示定制
• 一个Excel导出类的实现过程（三）：NPOI组件

接第三部分，由于单元格设置语句仅简单的一句话row.CreateCell(i).SetCellValue(value.ToString())，生成的Excel仍然粗陋。

Excel导出通常会遇到若干问题：

• 整数变字符串问题：整型值比如ID列，单元格左上角出现绿色三角符号，单元格变成了字符串类型，不够友好；
• 日期显示问题：有时候需要显示到日期如“2013-5-17”而不要带上“16:50:13”，有时候只希望显示“16:50”，而不是告诉使用人自己拿生成的工作薄设置格式；
• 科学计数法问题：手机号13912345678只是列宽过短时看起来像科学计数法，但超过15位的整数像1234567890123456就真变成1.23457E+15而且最后一位6变成了零。

ICell的实现者HSSFCell有数量不少的属性和方法帮助我们完成单元格格式设置，考虑到应用场景，创建指定类型的单元格并配合格式化选项已经能满足要求，下文使用若干强制转型和控制语句完成功能。

首先扩充Header类，添加一个Format参数。当使用者传入空Format参数时由我们推断单元格类型与值，而当使用者传入非空的Format参数时，我们调用ToString(String format)方法进行格式化。

public class Header
{
    public String Name { get; set; }
    public String PrintName { get; set; }
    public String Format { get; set; }

    public Header(String name)
        : this(name, name)
    {
    }

    public Header(String name, String printName)
        : this(name, printName, null)
    {
    }

    public Header(String name, String printName, String format)
    {
        Name = name;
        PrintName = printName;
        Format = format;
    }
}

我们把权力交给调用者时，便认为他的参数传递是经过判断且有道理的，比如纯数字的条形码显示可能需要调用Decimal.ToString("F0")方法，，但使用者对薪水调用ToString("P2")显示百分号就没办法了；另一部分是设计之初的问题，如双精度Double型精确度，后面再说。

由于ICell.CreateCell(int column, CellType type)创建的单元格类型最终由ICell.SetCellValue()重载版本中参数类型（可以是Boolean、DateTime、Double、String及IRichTextString）决定，所以统一只使用了ICell.CreateCell(int column)，必须注意的是用于存放数值的单元格类型枚举只有CellType.NUMERIC，下文还要讲到。新的Export改动点如刚才描述，旧的Person类及Export重载请见前文，实现如下：

public IWorkbook Export<T>(IList<T> records, IList<Header> headers)
{
    if (records == null)
        throw new ArgumentNullException("records");
    if (headers == null)
        throw new ArgumentNullException("headers"); //这里对headers集合非空、重复性、子元素非空引用等检查视具体需求

    PropertyInfo[] props = new PropertyInfo[headers.Count];
    for (Int32 i = 0; i < headers.Count; i++)
    {
        props[i] = typeof(T).GetProperty(headers[i].Name); //属性数组可能产生空元素
    }

    IWorkbook workbook = new HSSFWorkbook();
    ISheet sheet = null;
    IRow row = null;

    for (Int32 r = 0; r < records.Count; r++)
    {
        if ((r % RowPerSheet) == 0)
        {
            Int32 sheetIndex = (Int32)((Double)r / RowPerSheet) + 1;
            sheet = workbook.CreateSheet("Sheet" + sheetIndex); //工作表名，请按自己需求实现
            row = sheet.CreateRow(0); //创建表头
            for (Int32 i = 0; i < headers.Count; i++)
            {
                row.CreateCell(i).SetCellValue(headers[i].PrintName);
            }
        }

        row = sheet.CreateRow((r % RowPerSheet) + 1); //因为表头存在，行标需要下移1位
        for (Int32 i = 0; i < props.Length; i++)
        {
            if (props[i] != null) //空引用检查十分必要
            {
                Object value = props[i].GetValue(records[r], null);
                if (value != null) //空引用检查十分必要
                {
                    ICell cell = row.CreateCell(i);
                    if (props[i].PropertyType == typeof(Int32))
                    {
                        if (String.IsNullOrWhiteSpace(headers[i].Format))
                        {
                            cell.SetCellValue(((Int32)value));
                        }
                        else
                        {
                            cell.SetCellValue(((Int32)value).ToString(headers[i].Format));
                        }
                    }
                    else if (props[i].PropertyType == typeof(Double))
                    {
                        if (String.IsNullOrWhiteSpace(headers[i].Format))
                        {
                            cell.SetCellValue(((Double)value));
                        }
                        else
                        {
                            cell.SetCellValue(((Double)value).ToString(headers[i].Format));
                        }
                    }
                    else if (props[i].PropertyType == typeof(Decimal))
                    {
                        if (String.IsNullOrWhiteSpace(headers[i].Format))
                        {
                            cell.SetCellValue(Convert.ToDouble(value));
                        }
                        else
                        {
                            cell.SetCellValue(((Decimal)value).ToString(headers[i].Format));
                        }
                    }
                    else if (props[i].PropertyType == typeof(DateTime))
                    {
                        if (String.IsNullOrWhiteSpace(headers[i].Format))
                        {
                            cell.SetCellValue((DateTime)value);
                        }
                        else
                        {
                            cell.SetCellValue(((DateTime)value).ToString(headers[i].Format));
                        }
                    }
                    else
                    {
                        cell.SetCellValue(value.ToString());
                    }
                }
            }
        }
    }

    //调整每张Sheet列宽自适应
    for (Int32 i = 0; i < workbook.NumberOfSheets; i++)
    {
        sheet = workbook.GetSheetAt(i);
        for (Int32 h = 0; h < headers.Count; h++)
        {
            sheet.AutoSizeColumn(h);
        }
    }
    return workbook;
}

生日类数据显示到年月日即可，我们使用"yyyy-MM-dd"作为格式化参数，薪水未提供格式化参数，客户端调用代码如下：

static void Main(string[] args)
{
    Int32 records = 100;
    List<Person> persons = new List<Person>(records);
    for (Int32 i = 0; i < records; i++)
    {
        Person person = new Person();
        person.ID = i + 1;
        person.Name = "name" + (i + 1);
        person.Salary =  Math.Abs(Guid.NewGuid().GetHashCode() % 10000) + 5000;
        person.Birth = DateTime.Now;
        persons.Add(person);
    }

    List<ExcelHelper.Header> headers = new List<ExcelHelper.Header>();
    headers.Add(new ExcelHelper.Header("ID"));
    headers.Add(new ExcelHelper.Header("Name", "名称"));
    headers.Add(new ExcelHelper.Header("Birth", "生日", "yyyy-MM-dd"));
    headers.Add(new ExcelHelper.Header("Salary", "薪水"));

    ExcelHelper excelHelper = new ExcelHelper();
    excelHelper.RowPerSheet = 100;
    String path = @"d:\1.xls";
    IWorkbook workbook = excelHelper.Export<Person>(persons, headers);
    using (FileStream stream = File.Open(path, FileMode.OpenOrCreate))
    {
        workbook.Write(stream);
    }
}

之前提到过双精度的问题，对某个员工的薪酬设置为1234567890123456并输出Excel会怎么样，先做个测试：

Person person = new Person();
person.Salary = 1234567890123456;
Console.WriteLine(person.Salary);

输出结果是1.23456789012346E+15也就是说Excel上不仅显示的是科学计数法，而且数值已经变成悲了个剧的1234567890123460。粗暴地讲，这是因为双精度的Double型的有效位数造成的，并不是ToString方法或者Excel写入时产生了变化。

要处理类似问题，仅将Person.Salary声明为Decimal类型还不够，因为单元格类型CellType枚举中用来存数字的只有CellType.NUMERIC，没办法我们需要配合ToString("F0")（或者F2等视具体要求）把值当作字符串写入单元格，改动部分的部分代码如下：

...
public Decimal Salary { get; set; }
...
person.Salary = 1234567890123456M;
....
headers.Add(new ExcelHelper.Header("Salary", "薪水", "F0"));
...

于是能看到Excel上显示的1234567890123456，虽然有绿色小三角，好歹没变成科学计数法和四舍五入。如要求更完备请自行参考NPOI相关API，代码文件已提供，本文完。