基于Excel模板导出——ExcelTemplate

来源：互联网发布：云计算服务股票编辑：程序博客网时间：2024/05/29 15:55

什么是ExcelTemplate

ExcelTemplate项目是一个基于Excel模板，依靠配置文件描述导出过程的Excel导出工具。
它提供了大量适用于各种场景的常用配置（导出规则），同时提供一些供外部使用的扩展接口，以满足一些特殊应用。
比较适合于具有大量Excel导出功能的场景中。

ExcelTemplate依赖于NPOI项目实现对Excel的底层操作。

源码下载地址：https://github.com/gezhonglei/ExcelTemplate

为什么要基于Excel模板？

NPOI当然支持对Excel单元格各类外观样式的操作。但是基于外观的操作过于复杂（这跟NPOI工具本身没关系），可能比真正要导出数据的展示方式要写更多的代码。
但是从实际应用中发现，导出Excel的外观样式要求并不是太高，而且样式几乎都是有规律。
因此ExcelTemplate项目采用了基于Excel模板导出的方式：先手动制定一个Excel模板，然后从Excel模板中读取样式，然后在相同数据空间中复用这些样式。
这样，既消除了繁杂的样式书写逻辑，又保证了外观样式可自由配置。

使用配置文件描述导出规则有什么好处呢？

ExcelTemplate将一些常用导出规则固化为一个个配置项，导出数据的控制逻辑（在哪里输出？怎么输出？）完全由配置文件ExportConfig.xml定义。
为满足大多数场景，描述导出规则的这些配置项被定义到适宜的粒度，并可在各种场景中自由组合使用。
使用配置实现的导出逻辑，完全不用关心底层代码逻辑，在需求多变的环境中，只需修改配置相关参数即可，避免了修改代码逻辑和重新编译部署带来的麻烦。

为什么选择NPOI？

使用NPOI直接对Excel文档以文件流的直接处理，而不用安装并调用Office相关组件，大大简化了开发和部署的麻烦工作，而且性能较之office组件高很多。

如何使用？

* 你需要做什么 *

使用ExcelTemplate你需要做以下三步：
+ 手动制作Excel模板
+ 在ExcelTemplate.xml配置文件中配置使用什么数据，在哪里输出数据，怎么输出
+ 提供数据源DataSet，并使用ExportMain.Export()方法导出

OperationalPrinciple

* 示例 *
下面将以导出一个包含标题、图片、数据表等数据项的简单Excel为例说明ExcelTemplate使用步骤。

1.准备Excel模板: Demo.xlsx

2.配置导出规则

<?xml version="1.0"?><ExportConfig xmlns="http://tempuri.org/schema.xsd">  <ExportProduct name="Demo" description="An example" template="ExcelTemplate\Demo.xlsx">    <DataSource name="dsname">      <DataList name="SaveSource" value="√,"/>      <DataList name="WaySource" value="手工录入,自动产生,列表/弹出框选择"/>    </DataSource>    <Sheets>      <Sheet name="Sheet1">        <Cells>          <Cell location="B2" source="Cells.Title" />          <Cell location="C5:H18" source="Cells.Picture"  fill="stretch" />        </Cells>        <Tables>          <Table location="B23" source="Form">            <RowNum />            <Field name="Category1" colIndex="2" spannable="true"></Field>            <Field name="Category2" colIndex="3" spannable="true"></Field>            <Field name="Item" colIndex="4"  annnotationField="LinkAddr"                   refField="LinkAddr" linkType="auto"></Field>            <Field name="Save" colIndex="6" dropDownListSource="SaveSource" emptyFill="-"></Field>            <Field name="Way" colIndex="7" dropDownListSource="WaySource" emptyFill="-" spannable="true"></Field>            <Field name="Algorithm" colIndex="13" emptyFill="-"></Field>          </Table>        </Tables>      </Sheet>    </Sheets>  </ExportProduct></ExportConfig>

注意：如果这里的Table如果没有这些单元格横向纵向合并、下拉框、链接等特殊输出，只是纯文件内容的话，可以更简单配置如下

<ExportConfig xmlns="http://tempuri.org/schema.xsd">  <ExportProduct name="Demo" description="An example" template="ExcelTemplate\Demo.xlsx">    <Sheets>      <Sheet name="Sheet1">        <Cells>          <Cell location="B2" source="Cells.Title" />          <Cell location="C5:H18" source="Cells.Picture"  fill="stretch" />        </Cells>        <Tables>            <Table location="B23" source="Form" fields="Category1,Category2,Item,Save,Way,Algorithm">                <RowNum/>            </Table>        </Tables>      </Sheet>    </Sheets>  </ExportProduct></ExportConfig>

关于更多配置，请详见ExportConfigTemplete.xml。

3.准备数据源：DataSet

    DataSet dataSet = new DataSet("Demo");    DataTable dt = new DataTable("Cells");    dt.Columns.Add("Title");    dt.Columns.Add("Picture", typeof(byte[]));    dt.Rows.Add("来店登记统计表");    using (FileStream filestream = new FileStream(Path.Combine(path, "ExcelTemplate\\FormStyle.jpg"), FileMode.Open, FileAccess.Read))    {        byte[] bytes = new byte[(int)filestream.Length];        filestream.Read(bytes, 0, bytes.Length);        dt.Rows[0]["Picture"] = bytes;    }    dataSet.Tables.Add(dt);    dt = new DataTable("Form");    dt.Columns.Add("Category1");    dt.Columns.Add("Category2");    dt.Columns.Add("Item");    dt.Columns.Add("Save");    dt.Columns.Add("Way");    dt.Columns.Add("Algorithm");    dt.Columns.Add("Annotation");//用于批注    dt.Columns.Add("LinkAddr");//用于链接    dt.Rows.Add("来店管理", "来店登记", "日期", "√", null, null, "填写日期", "http://baidu.com");    dt.Rows.Add("来店管理", "来店登记", "销售顾问", "√", "手工录入", 1, "填写销售顾问名称", "file:///E:/DotNetWorkingSpace/MyTestPlatform/Console");    dt.Rows.Add("来店管理", "来店登记", "类型", "√", null, "2", "填写业务类型", "Sheet2!A1");    dt.Rows.Add("来店管理", "来店登记", "来店人数", "√", "手工录入", "3", "填写来店人数", "http://baidu.com");    dt.Rows.Add("来店管理", "其它", "来店时间", "√", "手工录入", "5", "填写来店时间", "mailto:test@126.com");    dataSet.Tables.Add(dt);    ExportMain.Export(dataSet, exportfilepath);