Excelize v2.0.0
- 发布日期: 2019年5月2日
- GitHub Release: https://github.com/xuri/excelize/releases/tag/v2.0.0
Release Notes
此版本中最显著的变化包括:
API 更改
下表列出了 v2.0.0 相比较于 v1.4.1 版本,API 的更改情况:
函数名 | 增加 error 返回值 | 行号计算方法变更* | 删除 | 新增 |
---|---|---|---|---|
ToALphaString | × | × | √ | × |
TitleToNumber | × | × | √ | × |
SplitCellName | × | × | × | √ |
JoinCellName | × | × | × | √ |
ColumnNameToNumber | × | × | × | √ |
ColumnNumberToName | × | × | × | √ |
CellNameToCoordinates | × | × | × | √ |
CoordinatesToCellName | × | × | × | √ |
DuplicateRowTo | × | × | × | √ |
SetCellFloat | × | × | × | √ |
SetCellStyle | √ | × | × | × |
InsertCol | √ | × | × | × |
RemoveCol | √ | × | × | × |
RemoveRow | √ | √ | × | × |
InsertRow | √ | √ | × | × |
DuplicateRow | √ | × | × | × |
SetRowHeight | √ | × | × | × |
GetRowHeight | √ | × | × | × |
GetCellValue | √ | × | × | × |
GetCellFormula | √ | × | × | × |
GetCellHyperLink | √ | × | × | × |
SetCellHyperLink | √ | × | × | × |
SetCellInt | √ | × | × | × |
SetCellBool | √ | × | × | × |
SetCellStr | √ | × | × | × |
SetCellDefault | √ | × | × | × |
GetCellStyle | √ | × | × | × |
SetCellValue | √ | × | × | × |
MergeCell | √ | × | × | × |
SetSheetRow | √ | × | × | × |
SetRowVisible | √ | √ | × | × |
GetRowVisible | √ | √ | × | × |
SetRowOutlineLevel | √ | √ | × | × |
GetRowOutlineLevel | √ | √ | × | × |
GetRows | √ | × | × | × |
Columns | √ | × | × | × |
SearchSheet | √ | × | × | × |
GetPicture | √ | × | × | × |
AutoFilter | √ | × | × | × |
GetColVisible | √ | × | × | × |
SetColVisible | √ | × | × | × |
GetColOutlineLevel | √ | × | × | × |
SetColOutlineLevel | √ | × | × | × |
SetColWidth | √ | × | × | × |
GetColWidth | √ | × | × | × |
GetMergeCells | √ | × | × | × |
ProtectSheet | √ | × | × | × |
UnprotectSheet | √ | × | × | × |
UpdateLinkedValue | √ | × | × | × |
SetSheetVisible | √ | × | × | × |
adjustHelper | √ | × | × | × |
adjustMergeCells | √ | × | × | × |
adjustAutoFilter | √ | × | × | × |
prepareCell | √ | × | × | × |
setDefaultTimeStyle | √ | × | × | × |
timeToExcelTime | √ | × | × | × |
addDrawingChart | √ | × | × | × |
addDrawingVML | √ | × | × | × |
addDrawingPicture | √ | × | × | × |
getTotalRowsCols | √ | × | × | × |
checkRow | √ | × | × | × |
addDrawingShape | √ | × | × | × |
addTable | √ | × | × | × |
workSheetReader | √ | × | × | × |
copySheet | √ | × | × | × |
* 从版本 v2.0.0 开始,所有行操作方法都使用从 1
开始的 Excel 行编号,早期版本中某些方法中的基于 0
的行编号将不再使用,参考相关 issue #349。
新增功能
- 新增 DuplicateRowTo() 方法, 支持根据给定的工作表名称(大小写敏感)和行号,在指定行后复制该行
- 工作表页面布局设置函数 SetPageLayout() 新增对页面布局方向设置的支持,解决了相关 issue #318
- 工作表页面布局设置函数 SetPageLayout() 新增对页面纸张大小设置的支持
问题修复
- 修复部分情况下,在样式格式中未指定单元格颜色填充时,创建了空白填充的问题
- 修复当工作表数据验证公式超过
225
个字符时,文件打开失败的问题,解决了相关 issue #339 - 修复部分情况下,删除带有公式的单元格会导致文件损坏的问题,解决了相关 issue #346
- 修复通过获取批注函数 GetComment(),从包含多个工作表的工作簿获取批注时,返回了错误的工作表名称的问题,解决了相关 issue #345
- 修复获取工作表全部单元格函数 GetRows() 返回多余的列的问题
- 修复部分情况下删除包含公式的工作表引起文档损坏的问题
性能提升
- 单元格赋值系列函数、添加批注、图片、图表、超链接和形状函数的性能,均获得了大幅提升
- 新增重复图片检查,将用添加引用代替添加重复图片,解决了相关 issue #359
下图是 v1.4.1 和 v2.0.0 版本下创建 12800 行 50 列工作表所执行时间和内存使用情况:
其他
- 文档内容更新与修正
- 完善单元测试,增加 go1.12 版本下的单元测试