2021-04-10 16:09:57 +08:00
## 更新日誌
---
2021-05-12 20:29:08 +08:00
< div align = "center" >
< a href = "https://www.nuget.org/packages/MiniExcel" > < img src = "https://img.shields.io/nuget/v/MiniExcel.svg" alt = "NuGet" > < / a > < a href = "https://www.nuget.org/packages/MiniExcel" > < img src = "https://img.shields.io/nuget/dt/MiniExcel.svg" alt = "" > < / a > < a href = "https://ci.appveyor.com/project/shps951023/miniexcel/branch/master" > < img src = "https://ci.appveyor.com/api/projects/status/b2vustrwsuqx45f4/branch/master?svg=true" alt = "Build status" > < / a >
< / div >
< div align = "center" >
< strong > < a href = "README.md" > English< / a > | < a href = "README.zh-CN.md" > 简体中文< / a > | < a href = "README.zh-Hant.md" > 繁體中文< / a > < / strong >
< / div >
< div align = "center" >
2021-06-19 18:03:08 +08:00
🙌 < a href = "https://github.com/shps951023/MiniExcel" > Star< / a > ,能幫助 MiniExcel 讓更多人看到 🙌
2021-05-12 20:29:08 +08:00
< / div >
2021-04-10 16:09:57 +08:00
---
2021-08-10 17:10:43 +08:00
### 0.17.3
2021-08-10 16:57:07 +08:00
- [New] 支持設定列寬 #280
2021-08-10 14:16:50 +08:00
- [Bug] 修復 csv 不支持 QueryAsDataTable #279
2021-07-02 13:41:28 +08:00
- [OPT] 更加清楚的錯誤訊息,當擋案是錯誤 excel zip 格式 #272
2021-06-30 17:21:15 +08:00
### 0.17.2
- [Bug] 修復 v0.16.0-0.17.1 自定義格式含有特定格式(e.g:`#,##0.000_);[Red]\(#,##0.000\)`),自動轉換器會將 double 被轉成 datetime 異常 #267
2021-06-23 14:59:47 +08:00
### 0.17.1
- [New] 增加 QueryAsDataTableAsync(this Stream stream..)
- [OPT] 強型別 Query 轉型錯誤訊息能知道在哪一行列出錯 [#I3X2ZL ](https://gitee.com/dotnetchina/MiniExcel/issues/I3X2ZL )
2021-06-21 12:04:34 +08:00
### 0.17.0
- [New] 支持 Async/Task #52 , contributor: [isdaniel ( SHIH,BING-SIOU) ](https://github.com/isdaniel )
2021-06-19 21:32:57 +08:00
### 0.16.1
- [New] SaveAsByTemplate 支持 DateTime 自定義格式 #255 , contributor: [网虫 (landde) - Gitee.com ](https://gitee.com/landde )
2021-06-17 17:21:13 +08:00
### 0.16.0
2021-06-19 18:03:08 +08:00
- [New] Query 支持自定義日期格式轉成 datetime 型別 #256
2021-06-17 17:21:13 +08:00
- [Bug] 修正 Query 重複呼叫 convertValueByStyleFormat 方法造成資源浪費 #259
2021-06-13 14:42:01 +08:00
### 0.15.5
2021-06-13 14:55:15 +08:00
- [Bug] 特定中文環境日期格式轉換InvalidCastException錯誤 #257
2021-06-13 14:42:01 +08:00
2021-06-08 17:12:12 +08:00
### 0.15.4
- [Breaking Change] CSV Reader/Writer 預設編碼改變 : UTF-8 => UTF-8-BOM
- [Breaking Change] 重新命名 CsvConfiguration GetStreamReaderFunc => StreamReaderFunc
2021-06-08 17:19:27 +08:00
- [New] Csv SaveAs 支持自定義 StreamWriter
2021-06-08 17:12:12 +08:00
2021-06-08 10:48:34 +08:00
### 0.15.3
- [New] Csv SaveAs 支持 datareader
2021-05-20 10:25:43 +08:00
### 0.15.2
- [New] 支持自定義日期時間格式 #241
2021-05-20 11:53:43 +08:00
- [Bug] CSV類型映射查詢錯誤 "cannot be converted to xxx type" #243
- [Bug] Stream 讀取 xls 文件時沒有錯誤異常拋出 #242
- [Breaking Change] 流無法識別文件類型, 請手動指定ExcelType
2021-05-20 10:25:43 +08:00
2021-05-19 21:32:41 +08:00
### 0.15.1
- [Bug] 修正 Sheetxml 結尾包含兩個 ">" 導致解析錯誤 #240
2021-05-19 17:13:47 +08:00
### 0.15.0
- [New] SaveAs 更改預設樣式、並提供樣式選擇 #132
2021-05-19 10:23:50 +08:00
- [New] SaveAs 支持 DataSet #235
2021-05-18 17:32:44 +08:00
### 0.14.8
- [Bug] 修正 csv Query 內文包含逗號造成異常 #237 #I3R95M
- [Bug] 修正 QueryAsDataTable 類別檢查異常,如 A2=5.5 , A3=0.55/1.1 系統會顯示 double type check error #233
2021-05-13 22:18:31 +08:00
### 0.14.7
- [New] SaveAs 支持建立多工作表
- [Breaking Change] 更換 GetSheetNames 返回類型 IEnumerable< string > -> List< string >
2021-05-13 11:41:07 +08:00
### 0.14.6
- [Bug] 修正 SaveAs by datareader 錯誤 "Invalid attempt to call FieldCount when reader is closed" #230
2021-05-12 20:29:08 +08:00
### 0.14.5
- [Breaking Change] 更換 OpenXmlConfiguration FillMergedCells 名稱
2021-05-12 16:33:06 +08:00
### 0.14.4
- [New] Query 支持向下填充合併的單元格 [#122 ](https://github.com/shps951023/MiniExcel/issues/122 )
2021-05-12 16:56:11 +08:00
- [Bug] 修正 QueryAsDataTable 錯誤 "Cannot set Column to be null" #229
2021-05-12 16:33:06 +08:00
2021-05-10 15:14:58 +08:00
### 0.14.3
- [Opt] 支持 Xlsm 自動判斷 #227
2021-05-12 16:33:06 +08:00
- [Bug] 修正 SaveAsByTemplate 單列 demension 索引錯誤 [#226 ](https://github.com/shps951023/MiniExcel/issues/226 )
2021-05-10 15:14:58 +08:00
2021-05-07 13:10:05 +08:00
### 0.14.2
2021-05-12 16:33:06 +08:00
- [Bug] 修正 asp.net webform gridview datasource 不能使用 QueryAsDataTable [#223 ](https://github.com/shps951023/MiniExcel/issues/223 )
2021-05-07 13:10:05 +08:00
2021-05-07 10:02:13 +08:00
### 0.14.1
2021-05-12 16:33:06 +08:00
- [Bug] 修正自定義 m/d 格式沒轉成 datetime [#222 ](https://github.com/shps951023/MiniExcel/issues/222 )
2021-05-07 10:02:13 +08:00
2021-05-06 15:47:08 +08:00
### 0.14.0
2021-05-12 16:33:06 +08:00
- [New] Query、GetColumns 支持 startCell 能指定 cell 開始讀取資料 [#147 ](https://github.com/shps951023/MiniExcel/issues/147 )
2021-05-06 15:47:08 +08:00
- [New] GetColumns 支持讀取表頭
2021-04-30 14:45:47 +08:00
### 0.13.5
2021-04-30 16:21:29 +08:00
- [New] 新增 QueryAsDataTable 方法 [#216 ](https://github.com/shps951023/MiniExcel/issues/216 )
2021-04-30 17:59:12 +08:00
- [New] SaveAs 支持 IDataReader value 參數 [#211 ](https://github.com/shps951023/MiniExcel/issues/211 )
2021-04-30 14:45:47 +08:00
- [Bug] 修正數字格式的字串會被強制轉換為decimal類型 [#I3OSKV ](https://gitee.com/dotnetchina/MiniExcel/issues/I3OSKV )
2021-04-30 16:21:29 +08:00
- [Opt] 優化 SaveAs 類別轉換算法,避免效率浪費
2021-04-30 14:45:47 +08:00
2021-04-23 14:28:24 +08:00
### 0.13.4
- [Changed] DataTable 以 Caption 優先當欄位名稱 #217
2021-04-26 11:28:10 +08:00
- [New] Query 支持 Enum mapping #89
2021-04-26 11:48:09 +08:00
- [OPT] 優化 stream excel 類別(xlsx or csv)檢查 #215
2021-04-23 14:28:24 +08:00
2021-04-20 16:19:47 +08:00
### 0.13.3
2021-04-22 13:57:37 +08:00
- [New] 支持 Excel 單純讀取模式,避免同時改模版又運行 MiniExcel 出現錯誤 "The process cannot access the file because it is being used by another process" [#87 ](https://github.com/shps951023/MiniExcel/issues/87 )
2021-04-21 19:23:48 +08:00
- [Breaking Change] CSV SaveAs datetime 預設格式改為 "yyyy-MM-dd HH:mm:ss"
2021-04-22 13:57:37 +08:00
- [Bug] 修正模版模式集合渲染遇到合併列會出現異常問題 [#207 ](https://github.com/shps951023/MiniExcel/issues/207 )
2021-04-22 14:42:43 +08:00
- [Bug] 修正 MiniExcel.SaveAs(path, value,sheetName:"Name"), 實際 sheetName 是 Sheet1
2021-04-20 16:19:47 +08:00
2021-04-20 09:57:15 +08:00
### 0.13.2
2021-04-22 13:57:37 +08:00
- [Bug] 超過 255 列無法讀取錯誤 [#208 ](https://github.com/shps951023/MiniExcel/issues/208 )
2021-04-20 09:57:15 +08:00
2021-04-18 10:57:50 +08:00
### 0.13.1
- [New] SaveAsByTemplate 支持讀取模板 byte[],方便緩存跟支持多用戶同時讀取同一個模板 [#189 ](https://github.com/shps951023/MiniExcel/issues/189 )
2021-04-18 12:39:40 +08:00
- [New] SaveAsByTemplate 支持傳入 `IEnmerable<IDicionary<string,object>> 或 DapperRows 或 DataTable` 參數 [#201 ](https://github.com/shps951023/MiniExcel/issues/201 )
2021-04-18 10:57:50 +08:00
- [Bug] 修正使用 stream SaveAs/SaveAsByTemplate 系統會自動關閉流 stream [#200 ](https://github.com/shps951023/MiniExcel/issues/200 )
2021-04-16 19:32:49 +08:00
### 0.13.0
- [New] 支持 .NET Framework 4.5 以上版本
- [Bug] 修正特殊情況Excel模板含有 namespace prefixFix 會造成模板解析錯誤 #193
- [OPT] 優化模板解析效率
2021-04-15 11:00:53 +08:00
### 0.12.2
- [Bug] 修正模板串接 Cell 類別不是字串問題 #179
- [Bug] 修正模板遇到非數字類別 t 是 str 問題 #180
2021-04-14 22:28:43 +08:00
### 0.12.1
- [OPT] 優化填充 Excel 效率
- [OPT] 模板集合列表支持類別自動判斷 (Issue #177 )
- [New] 新增 GetColumns 方法 (Issue #174 )
- [New] 模板支持 $rowindex 關鍵字獲取當前列索引
- [Bug] Dimension 沒有 x 字首 (Issue #175 )
2021-04-13 23:33:01 +08:00
### 0.12.0-beta
2021-04-13 15:19:39 +08:00
- [New] 支持`填充Excel`模式 ,借由 SaveAsByTemplate 方法以模板填充資料,
2021-04-10 16:09:57 +08:00
### 0.11.1
- [New] 支持 ColumnIndex Attribute [#142 ](https://github.com/shps951023/MiniExcel/issues/142 ) & [#I3I3EB ](https://gitee.com/dotnetchina/MiniExcel/issues/I3I3EB )
- [Bug] 修正 issue #157 : 特別情況無法使用指定 sheet name 查詢
- [Update] issue #150 : SaveAs 值集合錯誤訊息更明細
### 0.11.0
- [New] 添加 GetSheetNames 方法支持多 sheet 查詢
- [New] Query 指定 sheet 名稱
- [New] Csv SaveAs 支持 DataTable/Dictionary 參數
- [New] CsvConfiguration 支持自訂義 newLine & seperator & GetStreamReaderFunc
- [Optimization] 優化 SaveAs/Query excel 檔案類型自動判斷
### 0.10.3(請勿使用)
- [Bug] 修正 Query SharedStrings 控制字符沒有 encoding (issue [Issue #149 ](https://github.com/shps951023/MiniExcel/issues/149 ))
### 0.10.2
- [Bug] 修正 SharedStrings get wrong index (issue [#153 ](https://github.com/shps951023/MiniExcel/issues/153 ))
- [Bug] SaveAs 支持 control character encoding (issue [Issue #149 ](https://github.com/shps951023/MiniExcel/issues/149 ))
### 0.10.1(請勿使用)
- [New] SaveAs 支持 POCO excel 欄位名稱/忽略 attribute
### 0.10.0(請勿使用)
- [New] Query dynamic 表頭預設自動忽略空白字串欄位
- [New] Query 強型別支持自訂義 excel 欄位名稱/忽略 attribute
### 0.9.1(請勿使用)
- [Bug] 解決無法 mapping Cell Value 到 Nullable 屬性類別 (issue #138 )
### 0.9.0(請勿使用)
- [Bug] 解決 System.IO.Compression 引用兩次問題 (issue #97 )
- [Bug] 強型別 Query 空列會重複複製問題
### 0.8.0(請勿使用)
- [New] MiniExcel.Query 支持檔案路徑查詢
### 0.7.0(請勿使用)
- 優化 SaveAs 效率
- [Breaking Change] SaveAs value 參數類別檢查邏輯
### 0.6.0(請勿使用)
- [New] SaveAs 支持 參數 IEnumerable 延遲查詢
- [Breaking Change] 移除 SaveAs by object, 現在只支持 Datatable,IEnumerable< T > ,ICollection< T >
- [Bug] 修正空列生成 excel 錯誤 (issue: #128 )
### 0.5.0(請勿使用)
- [New] 支持 OpenXml Xlsx SaveAs writer 模式避免 OOM
- [Breaking Change] 移除 SaveAs startCell 參數
- [Bug] 修正 SaveAs dimension printHeader:true 異常
### 0.4.0(請勿使用)
- [New] 支持 create CSV by 檔案路徑或是 stream
- [New] 支持 csv 自訂義 configuration
- [New] 支持自動/手動指定 excel 類型 (xlsx or csv)
- [Breaking Changes] 移除 Query First/FirstOrDefault/Single/SingleOrDefault 方法, 使用者使用 LINQ 即可
### 0.3.0(請勿使用)
- [New] 支持 SaveAs by IEnumerable of DapperRow and IDictionary< string , object >
- [New] 支持 dynamic query timespan style 格式 mapping timespan 類別
### 0.2.3(請勿使用)
- [Bug] 修正記憶體洩漏問題
- [New] 支持 style datetime 格式 mapping datetime 類別.
### 0.2.2(請勿使用)
- SavaAs 支持 xl/sheet dimension
- [Breaking Changes] SaveAs value 類別準許 object & DataTable & ICollection
- [Bug] 修正 ICollection with type 沒有資料錯誤 (https://github.com/shps951023/MiniExcel/issues/105)
### 0.2.1(請勿使用)
- [Optimize] Optimize type mapping bool and datetime auto check
- [New] Query 支持 xl/worksheets/Sheet Xml `<c>` 沒有 `r` 屬性或是沒有 `<dimension>` 但 `<c>` 有 `r` 屬性情況, 但是效率會遠低於有 dimension ([](https://github.com/shps951023/MiniExcel/issues/2))
### 0.2.0(請勿使用)
- 發布至 nuget.org
### 0.1.0-preview
- [New] 添加 Query 強型別 mapping
- [New] 添加 QueryFirstOrDefault、QuerySingle、QuerySingleOrDefault
### 0.0.7-beta
- [New] 添加 QueryFirst 方法
### 0.0.6-beta
- [Breaking Changes] 替換 Create 名稱為 SavaAs
### 0.0.5-beta
- [Bug] Release 刪除 `assembly: InternalsVisibleTo` 依賴
### 0.0.4-beta
- [New] 支持 SaveAs Stream
### 0.0.3-beta
- [New] 支持 Query dynamic and IEnumrable 延遲查詢避免 OOM
- [New] MiniExcelHelper.Create value 類別換成 ICollection
- [New] Encode XML 值 `' " > < &`
- [New] 檢查多 Sheet Index 排序
- [New] Dynamic Query 支持 A,B,C.. 欄位名稱 key
- [New] 支持列與列之間空列情況
### 0.0.2-beta
- [New] 添加 MiniExcelHelper.Read 方法
- [Breaking Changes] 移除 System.IO.Packaging.Package 依賴, 換成 System.IO.Compression.ZipArchive
### 0.0.1-beta
- [New] 添加 MiniExcelHelper.Create 方法
### 0.0.0
- Init