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 模板，设置数据填充规则，然后直接填充数据vb.net教程即可快速转换为 Excel报表。

在网上没有找到较好ClosedXML.Report的示例，而且官方提供的使用示例实在太坑人了，也许该博主太"懒惰"了，所以今天写下该文章，方便后来者c#教程的使用，以免入坑太久。

二.如何使用

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