分享我基于NPOI+ExcelReport实现的导入与导出EXCEL类库:ExcelUtility (续篇)

  1. 云栖社区>
  2. 博客>
  3. 正文

分享我基于NPOI+ExcelReport实现的导入与导出EXCEL类库:ExcelUtility (续篇)

技术小牛人 2017-11-22 18:23:00 浏览995
展开阅读全文

上周六我发表的文章《分享我基于NPOI+ExcelReport实现的导入与导出EXCEL类库:ExcelUtility》受到了大家的热烈支持与推荐,再此表示感谢,该ExcelUtility类库自上次发文起,又经过了多次的改进,增加了许多的功能与方法,可以全面满足大家的需求,下面先来看一下新方法的测试结果:

第一个新增功能,列宽自适应,当超过30个字符则将单元格内容设为换行

任意一个无模板的导出方法均支持该功能,示例代码如下:

1
2
3
4
5
6
7
8
9
10
/// <summary>
/// 测试方法:测试将DataTable导出到EXCEL,无模板
/// </summary>
[TestMethod]
public void TestExportToExcelByDataTable()
{
    DataTable dt = GetDataTable();
    string excelPath = ExcelUtility.Export.ToExcel(dt, "导出结果");
    Assert.IsTrue(File.Exists(excelPath));
}

结果如下图示:

 

第二个新增功能,依据数据源(DataTable、DataGridView)的列类型自动将与之对应的EXCEL列的单元格式设为相同的格式内容显示,如:整数类型显示在单元格内无小数的数字格式,有小数位的类显示在单元格内2位小数数字格式,日期类型显示在单元格内日期+时间的日期格式,布尔类型显示在单元格内布尔格式,任意一个无模板的导出方法均支持该功能,示例代码如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
/// <summary>
/// 测试方法:测试将DataTable导出到EXCEL,无模板,且指定导出的列名,以及导出列名的重命名
/// </summary>
[TestMethod]
public void TestExportToExcelByDataTable3()
{
    DataTable dt = GetDataTable();
    string[] expColNames = { "Col1""Col2""Col3""Col4""Col5""Col7" };
    Dictionary<stringstring> expColAsNames = new Dictionary<stringstring>() {
        {"Col1","列一"},
        {"Col2","列二"},
        {"Col3","列三"},
        {"Col4","数字列"},
        {"Col5","列五"},
        {"Col7","日期列"}
    };
    string excelPath = ExcelUtility.Export.ToExcel(dt, "导出结果"null, expColNames, expColAsNames);
    Assert.IsTrue(File.Exists(excelPath));
}

结果如下图示:

 

第三个新增功能,在第二个新增功能的基础上,增加可以自定义设置列的单元格显示格式(支持日期类型、数字类型),任意一个无模板的导出方法均支持该功能,示例代码如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
/// <summary>
/// 测试方法:测试将DataTable导出到EXCEL,无模板,且指定某些列的显示格式
/// </summary>
[TestMethod]
public void TestExportToExcelByDataTable6()
{
    DataTable dt = GetDataTable();
    var colDataFormatDic = new Dictionary<stringstring>
    {
        {"Col4","0.000"}, //将Col4列DOUBLE类型的EXCEL对应列格式设置为显示成3位小数(默认为2位小数)
        {"Col7","yyyy-mm-dd"}//将Col7列DateTime类型的EXCEL对应列格式设置为年月日(默认为yyyy/mm/dd hh:mm:ss)
    };
    //更多设置格式可在EXCEL的设置单元格格式中的数字选项卡中的自定义格式列表(若无,可自定义,建议先在EXCEL中测试好格式字符串后再用于程序中)
 
    string excelPath = ExcelUtility.Export.ToExcel(dt, "导出结果", colDataFormats: colDataFormatDic);
    Assert.IsTrue(File.Exists(excelPath));
}

结果如下图示:

 

换种格式定义测试:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
/// <summary>
/// 测试方法:测试将DataTable导出到EXCEL,无模板,且指定某些列的显示格式
/// </summary>
[TestMethod]
public void TestExportToExcelByDataTable7()
{
    DataTable dt = GetDataTable();
    var colDataFormatDic = new Dictionary<stringstring>
    {
        {"Col4","¥#,##0.00_);(¥#,##0.00)"}, //将Col4列DOUBLE类型的EXCEL对应列格式设置为显示成包含货币格式,如:¥5.00(默认为2位小数)
        {"Col7","yyyy\"年\"m\"月\"d\"日\";@"}//将Col7列DateTime类型的EXCEL对应列格式设置为中文年月日,如:2015年12月5日(默认为yyyy/mm/dd hh:mm:ss)
    };
    //更多设置格式可在EXCEL的设置单元格格式中的数字选项卡中的自定义格式列表(若无,可自定义,建议先在EXCEL中测试好格式字符串后再用于程序中)
 
    string excelPath = ExcelUtility.Export.ToExcel(dt, "导出结果", colDataFormats: colDataFormatDic);
    Assert.IsTrue(File.Exists(excelPath));
}

结果如下图示:

注意事项说明:想要实现导出的EXCEL单元格依据数据类型自动设置或手动指定格式,需首先确保数据源的列与自动或手动设置的格式相符,即列类型必需是数字类型、日期类型、布尔类型,不能是以字符串的形式存在的这些所谓的“数字类型、日期类型、布尔类型”


第四个新增的功能,可指定DataGridView是否可以导出隐藏列(不显示的列)、及指定依据DataGridView标题列名导出相应列数据,示例代码如下:

1
2
3
4
5
6
7
8
9
10
/// <summary>
/// 测试方法:测试将DataGridView数据导出到EXCEL文件,无模板,且不导出隐藏列
/// </summary>
[TestMethod]
public void TestToExcelByDataGridView()
{
    var grid = GetDataGridViewWithData();
    string excelPath = ExcelUtility.Export.ToExcel(grid, "导出结果"nullfalse);
    Assert.IsTrue(File.Exists(excelPath));
}

结果如下图示:

 

第五个新增功能,DataGridView若改变列的显示位置,导出的数据也能与界面显示的数据同步调整,示例代码如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
/// <summary>
/// 测试方法:测试将DataGridView数据导出到EXCEL文件,无模板,改变列的显示位置,导出隐藏列
/// </summary>
[TestMethod]
public void TestToExcelByDataGridView2()
{
    var grid = GetDataGridViewWithData();
    //模拟改变列的显示位置
    grid.Columns[0].DisplayIndex = 1;
    grid.Columns[1].DisplayIndex = 0;
    string excelPath = ExcelUtility.Export.ToExcel(grid, "导出结果"nulltrue);
    Assert.IsTrue(File.Exists(excelPath));
}

结果如下图示:

以下是GetDataGridViewWithData模拟数据方法:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
private DataGridView GetDataGridViewWithData()
{
    var grid = new DataGridView();
    var dt = GetDataTable();
    foreach (DataColumn col in dt.Columns)
    {
        bool v = col.Ordinal > 4 ? false true;
        grid.Columns.Add(new DataGridViewTextBoxColumn() { DataPropertyName = col.ColumnName, HeaderText ="列名" + col.ColumnName , Visible = v,ValueType=col.DataType });
    }
    foreach (DataRow row in dt.Rows)
    {
        ArrayList values = new ArrayList();
        foreach (DataColumn col in dt.Columns)
        {
            values.Add(row[col]);
        }
        grid.Rows.Add(values.ToArray());
    }
    return grid;
}

  

我相信这些功能加上上次的功能,应该能满足大家日常工作中所遇到的各种导出EXCEL场景吧,下面重新公布一下两个核心的与导出相关类源代码,以供大家参考,若有不足之处,敬请指出,谢谢!

ExcelUtility.Export:

ExcelUtility.Base.Common:


第六个新增功能,支持模板中包含多个工作薄导出(目前这个方法还没有模拟测试,所以无法保证其一定有效,大家可以试试),该方法定义如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
/// <summary>
/// 由SheetFormatterContainer集合导出基于EXCEL模板(多工作薄)的文件
/// </summary>
/// <param name="templatePath"></param>
/// <param name="formatterContainers"></param>
/// <param name="filePath"></param>
/// <returns></returns>
public static string ToExcelWithTemplate(string templatePath,IDictionary<string,SheetFormatterContainer<dynamic>> formatterContainers, string filePath = null)
{
    if (!File.Exists(templatePath))
    {
        throw new FileNotFoundException(templatePath + "文件不存在!");
    }
 
    if (string.IsNullOrEmpty(filePath))
    {
        filePath = Common.GetSaveFilePath();
    }
 
    if (string.IsNullOrEmpty(filePath)) return null;
 
    string templateConfigFilePath = Common.GetTemplateConfigFilePath(templatePath, false);
 
    var workbookParameterContainer = new WorkbookParameterContainer();
    workbookParameterContainer.Load(templateConfigFilePath);
    List<SheetFormatter> sheetFormatterList = new List<SheetFormatter>();
    foreach (var item in formatterContainers)
    {
        SheetParameterContainer sheetParameterContainer = workbookParameterContainer[item.Key];
        sheetFormatterList.Add(new SheetFormatter(item.Key, item.Value.GetFormatters(sheetParameterContainer)));
    }
    ExportHelper.ExportToLocal(templatePath, filePath,sheetFormatterList.ToArray());
 
    return filePath;
}

 

该类库源码已分享到该路径中:http://git.oschina.net/zuowj/ExcelUtility    GIT Repository路径:git@git.oschina.net:zuowj/ExcelUtility.git   (会持续更新及修正BUG)

本文转自 梦在旅途 博客园博客,原文链接:http://www.cnblogs.com/zuowj/p/5133935.html  ,如需转载请自行联系原作者


网友评论

登录后评论
0/500
评论
技术小牛人
+ 关注