Magicodes.IE之花式导出

总体设计

Magicodes.IE是一个导入导出通用库，支持Dto导入导出以及动态导出，支持Excel、Word、Pdf、Csv和Html。在本篇教程，笔者将讲述如何使用Magicodes.IE进行花式导出。

在本篇教程，笔者主要讲述如何使用IE进行花式导出并满足客户爸爸的需求。

同一个数据源拆分Sheet导出

通常情况下，客户爸爸的需求是比较正常的，比如在数据量大时，希望将数据进行拆分导出。

这时候我们就需要使用IE按部就班开发了，先创建Dto：

<code>[ExcelExporter(Name = "测试2", TableStyle = "None", AutoFitAllColumn = true, MaxRowNumberOnASheet = 100)]public class ExportTestDataWithSplitSheet{/<code><code> [ExporterHeader(DisplayName = "加粗文本", IsBold = true)]/<code><code> public string Text { get; set; }/<code>
<code> [ExporterHeader(DisplayName = "普通文本")] public string Text2 { get; set; }/<code>
<code> [ExporterHeader(DisplayName = "忽略", IsIgnore = true)]/<code><code> public string Text3 { get; set; }/<code>
<code> [ExporterHeader(DisplayName = "数值", Format = "#,##0")]/<code><code> public decimal Number { get; set; }/<code>
<code> [ExporterHeader(DisplayName = "名称", IsAutoFit = true)]/<code><code> public string Name { get; set; }/<code>
<code> /// /<code><code> /// 时间测试/<code><code> /// /<code><code> [ExporterHeader(DisplayName = "日期1", Format = "yyyy-MM-dd")]/<code><code> public DateTime Time1 { get; set; }/<code>
<code> /// /<code><code> /// 时间测试/<code><code> /// /<code><code> [ExporterHeader(DisplayName = "日期2", Format = "yyyy-MM-dd HH:mm:ss")]/<code><code> public DateTime? Time2 { get; set; }/<code>
<code> public DateTime Time3 { get; set; }/<code>
<code> public DateTime Time4 { get; set; }}/<code>

如上述Dto定义所示，我们通过MaxRowNumberOnASheet属性指定了每个Sheet最大的行数，接下来仅需使用普通导出即可自动拆分Sheet导出：

<code> var result = await exporter.Export(filePath,/<code><code> GenFu.GenFu.ListOf(300));/<code>

是不是非常简单？作为一个正直和诚实的人，这时候我们可以评估为2天的工作量。

多个数据源多Sheet导出

过了一段时间，客户爸爸厌倦了各种表格，他有一个残暴的想法——乙方渣渣，能不能把这个表格做成一个表格导出！为了不被甲方爸爸按在地上摩擦，我们先跪下来。在各种讨价还价之后，我们Get到了5天的工作量。

对于导出多个数据，IE也做了充分的考虑：

Dto1:

<code>[ExcelExporter(Name = "测试", TableStyle = "Light10", AutoFitAllColumn = true, AutoFitMaxRows = 5000)]public class ExportTestDataWithAttrs{/<code><code> [ExporterHeader(DisplayName = "加粗文本", IsBold = true)]/<code><code> public string Text { get; set; }/<code><code> [ExporterHeader(DisplayName = "普通文本")] public string Text2 { get; set; }/<code><code> [ExporterHeader(DisplayName = "忽略", IsIgnore = true)]/<code><code> public string Text3 { get; set; }/<code><code> [ExporterHeader(DisplayName = "数值", Format = "#,##0")]/<code><code> public decimal Number { get; set; }/<code><code> [ExporterHeader(DisplayName = "名称", IsAutoFit = true)]/<code><code> public string Name { get; set; }/<code>
<code> /// /<code><code> /// 时间测试/<code><code> /// /<code><code> [ExporterHeader(DisplayName = "日期1", Format = "yyyy-MM-dd")]/<code><code> public DateTime Time1 { get; set; }/<code>
<code> /// /<code><code> /// 时间测试/<code><code> /// /<code><code> [ExporterHeader(DisplayName = "日期2", Format = "yyyy-MM-dd HH:mm:ss")]/<code><code> public DateTime? Time2 { get; set; }/<code>
<code> [ExporterHeader(Width = 100)]/<code><code> public DateTime Time3 { get; set; }/<code>
<code> public DateTime Time4 { get; set; }/<code>
<code> /// /<code><code> /// 长数值测试/<code><code> /// /<code><code> [ExporterHeader(DisplayName = "长数值", Format = "#,##0")]/<code><code> public long LongNo { get; set; }}/<code>

Dto2:

<code>[ExcelExporter(Name = "测试2", TableStyle = "None", AutoFitAllColumn = true, MaxRowNumberOnASheet = 100)]public class ExportTestDataWithSplitSheet{/<code><code> [ExporterHeader(DisplayName = "加粗文本", IsBold = true)]/<code><code> public string Text { get; set; }/<code>
<code> [ExporterHeader(DisplayName = "普通文本")] public string Text2 { get; set; }/<code>
<code> [ExporterHeader(DisplayName = "忽略", IsIgnore = true)]/<code><code> public string Text3 { get; set; }/<code>
<code> [ExporterHeader(DisplayName = "数值", Format = "#,##0")]/<code><code> public decimal Number { get; set; }/<code>
<code> [ExporterHeader(DisplayName = "名称", IsAutoFit = true)]/<code><code> public string Name { get; set; }/<code>
<code> /// /<code><code> /// 时间测试/<code><code> /// /<code><code> [ExporterHeader(DisplayName = "日期1", Format = "yyyy-MM-dd")]/<code><code> public DateTime Time1 { get; set; }/<code> 

<code> /// /<code><code> /// 时间测试/<code><code> /// /<code><code> [ExporterHeader(DisplayName = "日期2", Format = "yyyy-MM-dd HH:mm:ss")]/<code><code> public DateTime? Time2 { get; set; }/<code>
<code> public DateTime Time3 { get; set; }/<code>
<code> public DateTime Time4 { get; set; }}/<code>

以上代码定义了2个Dto，大家可以根据实际情况准备更多。接下来我们利用开篇所说的API来进行花式导出：

<code> var list1 = GenFu.GenFu.ListOf;/<code><code> var list2 = GenFu.GenFu.ListOf(30);/<code><code> var result = await exporter .Append(list1)/<code><code> .SeparateByColumn.Append(list2)/<code><code> .SeparateByColumn.Append(list2)/<code><code> .ExportAppendData(filePath);/<code>

如上述代码所示，我们通过Append添加了三个数据源，通过两次SeparateByColumn进行了拆分，最后通过ExportAppendData来导出：

导出结果如图所示。值得注意的是，两个Dto使用了不同的主题，因此多个导出也保持了不同的导出风格，是不是很赞呢？客户爸爸也觉得很赞，但是他还是觉得应该按Sheet拆分会比较直观。于是你被乙方领导按在地上摩擦了一会，然后给了你两天的时间。

多个数据源按Sheet拆分导出

因为摩擦产生了静电，所以你很快想到了IE肯定有相关的实现：

<code>var result = exporter .Append(list1, "sheet1")/<code><code> .SeparateBySheet/<code><code> .Append(list2)/<code><code> .ExportAppendData(filePath);/<code>

如上述代码所示，我们将分割函数改为了SeparateBySheet，结果如下图所示：

不过值得注意的是，Append函数支持传递Sheet名称来覆盖默认的Sheet命名，以便大家可以通过这些API动态灵活的导出。

多个数据源按行拆分导出

客户爸爸收到了你的更改，很是开心，决定给你一个奖赏——这不是我要的，我要分行导出。在被摩擦的几十年生涯中，你深刻的知道怼怒的结果无法是被一次一次的摩擦。

不过这次你心里有数，默默的报了7天的工作量，使用IE秒改，然后花了7天的时间来演戏：

<code>var result = await exporter .Append(list1)/<code><code> .SeparateByRow/<code><code> .Append(list2)/<code><code> .ExportAppendData(filePath);/<code>

如上述代码所示，在导出领域，IE不是万能的，但是没有IE是万万不能的。通过修改SeparateByRow，我们就毫秒级完成了客户的需求：

7天后，客户拿到报表，欣喜之余习惯性的又想摩擦，哦，指出了一个问题：数据量太大，我希望表头时时刻刻的展现在我眼前！然后你装作苦逼的再报了7天的工作量，再次祭出IE秒改：

<code>var result = await exporter .Append(list1)/<code><code> .SeparateByRow/<code><code> .AppendHeaders/<code><code> .Append(list2)/<code><code> .ExportAppendData(filePath);/<code>

如上述代码所示，我们通过AppendHeaders完成了追加表头的需求，从此走上了人生巅峰：

最后

通过本篇教程，我想大家明白了一个道理：人生如戏，全靠演技。当你有IE作为后盾时，在甲方爸爸面前，你就可以尽情的跪拜了！

不过我们还是来做一个总结，在本教程中，只要你掌握了以下API，你就可以赢取白富美，走上人生巅峰了：

API说明Append追加数据源，支持传递Sheet名称AppendHeaders追加表头SeparateByColumn通过追加Column分割导出SeparateBySheet通过Sheet分割导出SeparateByRow通过追加行来分割导出ExportAppendData导出追加数据

转载是一种动力 分享是一种美德

如果喜欢作者的文章，请关注【麦扣聊技术】订阅号以便第一时间获得最新内容。本文版权归作者和湖南心莱信息科技有限公司共有，欢迎转载，但未经作者同意必须保留此段声明，且在文章页面明显位置给出原文连接，否则保留追究法律责任的权利。

文档官网：docs.xin-lai.com

编程交流群<85318032>

产品交流群<897857351>