c# ClosedXML.Report excel报表排坑
一.介绍closedxml.report
closedxml.report开源报表 支持net4.0+。
github:https://github.com/closedxml/closedxml.report
github项目下载慢参考:https://blog.csdn.net/czjnoe/article/details/106034095
一个可以生成excel报表的工具,创建一份xlsx 模板,设置数据填充规则,然后直接填充数据即可快速转换为 excel报表。
在网上没有找到较好closedxml.report的示例,而且官方提供的使用示例实在太坑人了,也许该博主太"懒惰"了,所以今天写下该文章,方便后来者的使用,以免入坑太久。
二.如何使用
1.首先创建xlsx模板
注意:上图红色区域,需要在excel中,设置区域名称为item,否则无法填充数据
2.c# demo示例
首先添加closedxml(0.95.0.0)、closedxml.report(0.2.0.0),不要在nuget直接下载,最好下载官方开源项目,引用项目下的dll,或者直接使我的demo中的引用,在文章末尾
创建所需实体:
public class student { public int id { get; set; } public string name { get; set; } public int age { get; set; } } public class course { public int id { get; set; } public string name { get; set; } public double grade { get; set; } public item items { get; set; } } public class item { public int id { get; set; } public string name { get; set; } }
代码示例:
const string outputfile = @".\output\report.xls";//输出目录 var template = new xltemplate(@".\template\student.xls");//模板目录 student stu = new student { age = 25, id = 1, name = "財政局", }; dictionary<string, string> dic = new dictionary<string, string>(); dic["id"] = "1"; dic["age"] = "25"; dic["name"] = "財政局"; //addvariable(object)方法,可传入实体、字典 { //template.addvariable(stu);//传入单个实体 template.addvariable(dic);//传入字典 } //addvariable(string alias, object value)方法,可以传入集合、动态类型、datatable。如果希望输出多个table表,建议传入集合 //注意key值必须为item { ienumerable<dynamic> courseitems() { return new list<dynamic> { new { id=1, name="数学", grade=89,items=new { id=1,name="1"} }, new { id=2, name="英语", grade=15,items=new { id=2,name="2"} }, new { id=3, name="语文", grade=100,items=new { id=3,name="3"} }, }; } var course = new list<course> { new course{ id=1, name="数学", grade=89 , items=new item{ id=1,name="1"}}, new course{ id=2, name="英语", grade=15, items=new item{ id=2,name="2"}}, new course{ id=3, name="语文", grade=100, items=new item{ id=3,name="3"}} }; datatable dt = new datatable(); dt.columns.add("id", typeof(int)); dt.columns.add("name", typeof(string)); dt.columns.add("grade", typeof(int)); var newrow = dt.newrow(); newrow["id"] = 1; newrow["name"] = "数学"; newrow["grade"] = 89; dt.rows.add(newrow); newrow = dt.newrow(); newrow["id"] = 2; newrow["name"] = "英语"; newrow["grade"] = 15; dt.rows.add(newrow); newrow = dt.newrow(); newrow["id"] = 3; newrow["name"] = "语文"; newrow["grade"] = 100; dt.rows.add(newrow); //template.addvariable("item", courseitems());//动态类型 template.addvariable("item", course);//集合 key必须为item //template.addvariable("item", dt);//datatable } template.generate(); template.saveas(outputfile);//输出excel文件 //打开excel文件 process.start(new processstartinfo(outputfile) { useshellexecute = true });
3.输出excel:
三.总结
如果你只是处理一些简单的报表输出或只需要输出一张table表,还是可以使用的,毕竟比npoi输出简单多了,否则不建议使用
closedxml.report缺点:
1.只能处理简单的数据插入,如果想要输出多个table表的话,则会麻烦一点,这点非常不友好。
2.输出表格table,需要指定excel一块区域,且把该区域设置名称为item。
3.不支持xls格式。只支持如下格式。'.xlsx', '.xlsm', '.xltx' and '.xltm'.
我的demo:https://gitee.com/czjnoe/closedxml.reportdemo