# FlashExcel

**Repository Path**: pinyangwenjie/FlashExcel

## Basic Information

- **Project Name**: FlashExcel
- **Description**: FlashExcel is excel export tools.
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 4
- **Created**: 2024-03-26
- **Last Updated**: 2024-03-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# FlashExcel
FlashExcel（闪电导表工具）是一个界面化的表格导出工具。使用简单，导出急速，支持批量化，支持多语言，支持单元格公式，支持命令行参数，基本满足策划各类需求。工具自带的导出器也可以满足大部分项目需求，当然也可以编写自定义的导出器。

![image](https://github.com/gmhevinci/FlashExcel/raw/master/Docs/Image/img1.png)

## 工程
VS2017 && .net framework 4.6
1. NuGet package : NPOI
2. NuGet package : SharpZipLib

## 导出器
1. **TXT文本导出器**  
生成一个包含所有表格数据的纯文本，一般多用于C++逻辑服务器。  

2. **LUA脚本导出器**  
生成一个包含所有表格数据的Lua脚本。  

3. **ILR脚本导出器**  
生成一个包含所有表格数据的CS脚本，一般多用于支持ILRuntime的客户端框架。  

4. **BYTE文件导出器**  
生成一个包含所有表格数据的二进制格式的文件，需要 [CS脚本导出器] 配合。  

5. **CS脚本导出器**（需要MotionFramework.IO库）  
[MotionFramework](https://github.com/gmhevinci/MotionFramework)是一套基于Unity3D引擎的游戏框架。  
配合 [BYTE文件导出器]，生成一个支持读取二进制数据的CS脚本。该CS脚本可以实现解析零GC。

## 自定义导出器
创建自定义的导出器非常简单，在工程目录里创建一个继承自BaseExporter的CS类，通过ExportAttribute属性可以设置导出器名称。脚本准备完毕之后我们再次运行程序，会发现导出器列表里已经有了我们自定义的导出器。
```C#
[ExportAttribute("导出TXT文件")]
class TextExporter : BaseExporter
{
	public TextExporter(SheetData sheetData)
	  : base(sheetData)
	{
	}
  
	public override void ExportFile(string path, string createLogo)
	{
          //可以参考默认自带的导出器来编写你的代码
	}
}
```

## 设置
1. 整形和浮点型的数值单元格，如果策划忘记填写而为空，那么导出的时候工具会报错。我们也可以设置数值单元格自动补齐功能，来规避这个问题。
2. 对于CS脚本导出器和ILR脚本导出器，我们可以写入自定义的命名空间，例如：ILRExporter[MyNamespaceName1];CSExporter[MyNamespaceName2]  
![image](https://github.com/gmhevinci/FlashExcel/raw/master/Docs/Image/img4.png)

## 多语言支持
工具提供了完整的多语言解决方案，自动生成多语言汇总表格。在我们导出选择的表格的时候，工具会自动把这些表格里的所有多语言列汇总到多语言总表。如果我们想导出所有表格里的多语言内容，那么可以点击界面里的[**多语言 自动化**]按钮，它会检查所有表格里的多语言列并进行汇总。

## 单元格公式支持
单元格支持数值公式和字符串公式。例如：同一个Excel里的不同页签里的单元格可以通过Excel公式互相引用关联。

## 命令行参数支持
支持传入命令行参数。当前支持传入需要导出的Excel文件路径，参考Test.bat批处理。

## 表格结构
表格结构支持定义各种类型：整型，浮点型，布尔，枚举，多语言，字符串，列表，自定义类型。  

![image](https://github.com/gmhevinci/FlashExcel/raw/master/Docs/Image/img2.png)

![image](https://github.com/gmhevinci/FlashExcel/raw/master/Docs/Image/img3.png)

1. 第一行为类型
2. 第二行为名称
3. 第三行为导出标记：客户端(C)，战斗服务器(B)，逻辑服务器(S)。

## 注意事项
Excel内可以设立多个页签，前缀t_的页签会被识别并导出，其它页签可以作为策划的辅助页签或备注页签

## 警告
Excel2003后缀是.xls文件最大支持65536行，256列  
Excel2007后缀是.xlsx文件最大支持1048576行，16384列