變更日志：更新、里程碑、路線圖

Translated

View the article in English

IronXL 路線圖

IronXL 是為了讓開發人員能夠輕鬆使用 C# 和所有其他 .NET 語言讀取和創建 XLS、XLSX 和 CSV 文件而創建的。

IronXL 領先業界，致力於讓開發人員在 C# 中編輯 Excel 文件，而不需要使用 Office Interop。

今天我們的團隊專注於進一步推進IronXL，優先考慮來自開發者社群的反饋意見。

版本釋出以每月為頻率進行，新功能使IronXL成為許多開發人員的首選。

從長遠來看，我們計劃推出適用於多種編程語言的IronXL。早期研發正在進行中，以開發進一步的 MS Office 產品，包括 Word、PowerPoint 和其他 Microsoft Office 套件。

2024年10月

IronXL 2024.10.2

2024年10月3日

版本 2024.9.3

功能與升級

https://www.nuget.org/packages/IronXL.Excel/2024.10.2

發布說明：

將 IronSoftware.System.Drawing 更新至版本 2024.9.11

2024年9月

IronXL 2024.9.3

2024年9月3日

版本 2024.9.3

功能與升級

https://www.nuget.org/packages/IronXL.Excel/2024.9.3

發布說明：

小錯誤修正

2024年8月

IronXL 2024.8.5

2024年7月30日

版本 2024.8.5

功能與升級

https://www.nuget.org/packages/IronXL.Excel/2024.8.5

發布說明：

小錯誤修正

2024年7月

IronXL 2024.7.1

2024年7月5日

版本 2024.7.1

功能與升級

https://www.nuget.org/packages/IronXL.Excel/2024.7.1

發布說明：

小錯誤修正

2024年6月

IronXL 2024.6.1

2024年6月4日

版本 2024.6.1

功能與升級

https://www.nuget.org/packages/IronXL.Excel/2024.6.1

發布說明：

小錯誤修正

2024年5月

IronXL 2024.5.5

2024年4月29日

版本 2024.5.5

功能與升級

https://www.nuget.org/packages/IronXL.Excel/2024.5.5

發布說明：

小錯誤修正
將 IronSoftware.System.Drawing 更新至版本 2024.5.1

2024年4月

IronXL 2024.4.4

2024年4月4日

版本 2024.4.4

功能與升級

https://www.nuget.org/packages/IronXL.Excel/2024.4.4

發布說明：

修復了「共享」公式的錯誤(跨多個儲存格複製的類型)保存檔案時會遺失。
更新 IronSoftware.System.Drawing 至版本 2024.4.1

2024年3月

IronXL 2024.3.20

2024年3月11日

版本 2024.3.20

功能與升級

https://www.nuget.org/packages/IronXL.Excel/2024.3.20

發布說明：

將 IronSoftware.Common 更新至版本 2024.1.7
更新 IronSoftware.System.Drawing 至版本 2024.3.4
修正了一個在 .NET Framework 中無法從 web.config 文件讀取授權金鑰的錯誤。

2024年2月

IronXL 2024.2.25

2024年1月29日

版本2024.2.25

功能與升級

https://www.nuget.org/packages/IronXL.Excel/2024.2.25

發布說明：

將 IronSoftware.Common 更新至版本 2024.1.2
修正了從 DataSets 加載數據的方法執行速度非常慢的錯誤。(即 LoadWorkSheetsFromDataSet 方法)
由於上述修正，許多其他創建大量單元格的方法性能得到了改善。
修正了導致對儲存格的任何樣式更改會將儲存格前景色設為黑色的錯誤。
IronXL.Cell.Int64Value 和 IronXL.Cell.Int32Value 方法已被廢棄，將在未來移除。改用 IronXL.Cell.IntValue 和 IronXL.Cell.LongValue
新增 IronXL.Cells.Comment 類別，以表示具有所有註解屬性設置器和取得器的單元格註解。
將 Comment 屬性添加到 IronXL.Cell 類中，並提供添加和刪除註釋的方法。如果儲存格沒有註解，則 Comment 屬性為 null。註釋會預設為不可見添加

2024年1月

IronXL 2024.1.21

2023年12月29日

版本 2024.1.21

功能與升級

https://www.nuget.org/packages/IronXL.Excel/2024.1.21

發布說明：

小幅改進和錯誤修復

2023年12月

IronXL 2023.12.19

2023年12月1日

版本 2023.12.19

功能與升級

https://www.nuget.org/packages/IronXL.Excel/2023.12.19

發布說明：

修正了在創建已定義名稱時拋出異常的錯誤。
修復了載入包含圖表工作表的試算表時拋出錯誤的問題。請注意，圖表工作表仍然不會被加載。支持圖表工作表仍然是一項功能請求。
新增功能，將命名表格轉換為 DataTables。
新增對資料驗證的支援：
DataValidations 屬性已新增到 WorkSheet。它包含工作表中的所有數據驗證，並包含添加和移除數據驗證的方法。
可以从電子表格中读取所有数据验证类型。
可以將 WholeNumber、Decimal、TextLength、Date、List 和 FormulaList 數據驗證添加到 WorkSheet。

2023年11月

IronXL 2023.11.12

2023年10月27日

版本 2023.11.12

功能與升級

https://www.nuget.org/packages/IronXL.Excel/2023.11.12

發布說明：

IronDrawing 已更新至版本 2023.11.1
小修復與改進
IronXL.Logger 類別已經不建議使用。請改用 IronSoftware.Logger

2023年10月

IronXL v2023.10.8

2023年10月5日

2023.10.8 版本

功能與升級

https://www.nuget.org/packages/IronXL.Excel/2023.10.8

發布說明：

IronDrawing 已更新至版本 2023.10.2
新增對 IronSoftware.Common 2023.10.2 的依賴性。
小修復與改進

2023年9月

IronXL v2023.9.29

2023年9月19日

版本 2023.9.29

功能與升級

https://www.nuget.org/packages/IronXL.Excel/2023.9.29

發布說明：

IronDrawing 更新至版本 2023.9.2
穩定性改進
執行時間在某些情況下提高多達25%的性能提升

2023年8月

IronXL v2023.8.19

2023年7月31日

版本 2023.8.19

功能與升級

https://www.nuget.org/packages/IronXL.Excel/2023.8.19

發布說明：

小幅改進和修復。
更新依賴項。

2023年7月

IronXL v2023.7.4

2023年7月6日

版本 2023.7.4

功能與升級

https://www.nuget.org/packages/IronXL.Excel/2023.7.4

發布說明：

添加 合併區域 此方法用於檢索合併區域列表。
修正了一个错误，其中 清除 方法沒有刪除集合中的所有工作表。
修正了一个错误，其中 插入欄 方法跳過最後一行。
修正了一个错误，其中 範圍.ToDataTable 方法在遇到空行時會停止轉換。
新增 移除列 方法群組至 範圍, 範圍Row, 範圍Column, 工作表.
插入欄 方法組現在將正確地將列移開，更新公式並將樣式隨單元格移動。
在某些大量數據處理情況下，性能時間提升20-25%。
不推薦使用該 範圍.AllRowsIn範圍 和 範圍.AllColumnsIn範圍 屬性，使用 範圍.Rows 和 範圍.Columns 取而代之。這同樣適用於 工作表, 範圍Row 和 範圍Column 類別。
工作表's internal working range will now correctly update with all changes made to the worksheet
工作表's internal working range will now include the empty columns at the end of the range which hold any styling information.
修復了許多錯誤在 範圍.修剪 方法，包括其中一個錯誤情況 修剪 不會修剪空列。
範圍.移除列 和 範圍.移除Row 現在的方法將始終完全從工作表中移除列/行，如果移除後該列/行為空，則會將位於移除的列/行下方/右側的列/行向上/向左移動。
新增 範圍.Count 屬性，返回範圍內的單元格數量，而不需要遍歷所有單元格。
更改 範圍.ColumnCount 和 範圍.RowCount 屬性來返回範圍內的列/行數量，而不用遍歷所有的單元格。
Improves documentation for 範圍 class 和 its heirs.
插入行 和 插入欄 方法現在將返回插入的行/列。對於 插入行s 和 插入欄s 方法，但這些方法將返回插入的列/行列表。
範圍's address will now be correctly updated when the range is changed (with 修剪/插入/移除/減去 方法）。
新增 工作表.範圍Address 屬性與工作表中使用區域的地址
更新 IronSoftware.System.Drawing 至版本 2023.7.1

2023年6月

IronXL v2023.6.4

2023年5月29日

版本 2023.6.4

功能與升級

https://www.nuget.org/packages/IronXL.Excel/2023.6.4

發布說明：

新增 設置邊框樣式 方法，用於設定邊框類型和顏色。
修復了一個錯誤，該錯誤是在保存後，圖表系列中的“&”符號會破壞生成的文件。
修復了一個錯誤，當.xlsx （.xlsm，.xltx 等）文件在其內部 XML 結構中有一個開頭和結尾的 br 標籤時會發生 - WorkBook.Load 該方法會拋出異常。
將 IronDrawing 依賴項更新至版本 2023.6.1。

2023年5月

IronXL v2023.5.4

2023年5月1日

版本 2023.5.4

功能與升級

https://www.nuget.org/packages/IronXL.Excel/2023.5.4

發布說明：

修复在某些 .NET Framework ASP.NET 项目中从 web.config 无法获取许可证密钥的问题
修復可能的 System.Memory 版本衝突警告

2023年3月

IronXL v2023.4.13

2023年3月29日

版本 2023.4.13

功能與升級

https://www.nuget.org/packages/IronXL.Excel/2023.4.13

發布說明：

新增對 IronSuite 授權金鑰的支援
修正 IronXL 無法讀取儲存在 .config 和 .json 文件中的授權金鑰問題
添加對存儲在應用程式子文件夾中的.config 和 .json 文件內的許可證密鑰的支持

2023年2月

IronXL v2023.2.5

2023年2月27日

版本 2023.2.5

功能與升級

https://www.nuget.org/packages/IronXL.Excel/2023.2.5

發布說明：

安裝 NuGet 套件前，現在需要同意 EULA 條款。
改進 Range 類別的智能感知描述
修正了一個錯誤，當試圖訪問不存在任何欄的工作表時，會拋出異常的 WorkSheet.PhysicalColumnCount 屬性。
改進 Cell.Hyperlink 屬性的智能提示描述
修正了一個錯誤，在某些情況下設置 Cell.Hyperlink 屬性會檢測到錯誤的超連結類型。
改進了在系統中找不到字體時使用 AutoSizeRow/AutoSizeColumn 方法時發生的異常描述
更新依賴項

2023年1月

IronXL v2023.1.14

2023年1月31日

版本 2023.1.14

功能與升級

https://www.nuget.org/packages/IronXL.Excel/2023.1.14

發布說明：

用於 WorkSheet.InsertImage 方法的列舉已更改為 IronXL.Drawing.Images.ImageFormat
修正了一個錯誤，該錯誤在不同地區中由於小數點分隔符而導致圖表變得損壞
效能提升

2022年12月

IronXL v2022.12.11262

2022年12月29日

版本 2022.12.11262

功能與升級

https://www.nuget.org/packages/IronXL.Excel/2022.12.11262

發布說明：

修復了一個錯誤，其中 授權 當使用 Visual Studio 調試器掛接並執行使用 IronXL 的應用程式時，將拋出異常。
修復了一個錯誤，即刪除多個圖表之一後再添加另一個圖表會引發異常。
圖表標題將不再覆蓋圖表區域。

IronXL v2022.12.10926

2022 年 12 月 8 日

版本 2022.12.10926

功能與升級

https://www.nuget.org/packages/IronXL.Excel/2022.12.10926

發布說明：

修复了一個錯誤，WorkBook.ExportToHtml 由於文件中未索引的顏色而引發了一個異常。
修復了一個錯誤，當調用 Range、WorkSheet、RangeRow、RangeColumn、RangeStyle、RangeFont 和 RangeBorder 的屬性 getter 時，會不必要地創建範圍內的所有單元格
修復了一個錯誤，當加載具有特定 WebPublishing 設定的 .XLSX 檔案時，會拋出異常
添加了 `WorkSheet.PhysicalColumnCount` 和 `WorkSheet.PhysicalRowCount` 屬性，這些屬性返回當前此工作表中實際存在的列數和行數。
改進和更新 IntelliSense 文檔，以清晰地解釋部分 WorkSheet 和 Range 的屬性和方法
當讀取 Range 物件的任何屬性時，提升性能，特別是在處理大範圍時。這適用於從 Range 繼承的所有物件（如 WorkSheet，RangeRow 等）。

2022年11月

IronXL v2022.11.10251

2022年11月2日

版本 2022.11.10251

功能與升級

https://www.nuget.org/packages/IronXL.Excel/2022.11.10251

發布說明：

為 WorkBook 加載方法新增重載，以接受加密的 XLSX、XLSM 和 XLTX 工作簿的密碼。新增重載的完整列表：
- TryLoad(string filename, string password, out WorkBook workBook)
- 載入（byte [] 資料，string 密碼）
- 載入(Stream stream, string password)
- 加載Excel（byte[] 資料, string 密碼）
- LoadExcel(Stream file, string password)
- LoadExcel(string filename, string password)
- 從位元組陣列(byte[] data, string password)
- 從Stream(Stream stream, string password)
新增了一個方法 WorkBook.Encrypt(string password)，該方法將工作簿寫入 MemoryStream，使用作為參數提供的密碼或存儲在 WorkBook.Password 屬性中的密碼進行加密，並返回加密後的 MemoryStream。僅支援 XLSX、XLSM 和 XLTX 類型的工作簿。
新增方法 WorkBook.Decrypt(Stream stream, string password)，此方法會解密提供的Stream和密碼，並返回解密後的MemoryStream。僅支援XLSX、XLSM 和XLTX類型的工作簿。
修正了在將工作簿導出為HTML時某些邊框樣式會導致異常的錯誤
修復了一個錯誤，該錯誤在 InsertRow 方法將行插入到最後一行位置時會拋出異常。
改進了AutoSizeRow和AutoSizeColumn方法的精準度
将 InsertRow 方法的性能提升了 25%

2022年9月

IronXL v2022.9.9454

2022年9月29日

版本 2022.9.9454

功能與升級

https://www.nuget.org/packages/IronXL.Excel/2022.9.9454

發布說明：

修復了首個創建的 ConditionalFormattingRule 無法正常工作的錯誤
修正了條件格式規則未應用字體顏色的錯誤
修復了在 .xlsx 中當變更 Cell.FormatString 屬性時產生重複樣式的錯誤。
修復了一個錯誤，該錯誤導致 Range.Row(int) 和 Range.Column(int) 方法在處理大範圍時可能需要幾分鐘才能執行
新增了一個列舉 IronXL.SortOrder，以指示在適用時排序的方向。
新增 Range.SortByColumn(string, SortOrder) 和 Range.SortByColumn(int, SortOrder) 方法，允許通過指定的列對範圍進行排序，根據指定列的新順序重新排列被排序的範圍行。
刪除對IronDrawing nuget封包的依賴，並用IronSoftware.System.Drawing取代。

IronXL v2022.9.8711

2022年9月2日

版本 2022.9.8711

功能與升級

https://www.nuget.org/packages/IronXL.Excel/2022.9.8711

發布說明：

修复了一些在上一个版本中被错误模糊处理的方法的问题。受影响的方法列表如下：IronXL.Cells.CellFont.SetColor(Color), IronXL.Cells.CellStyle.SetBackgroundColor(Color), IronXL.Cells.XlsCellBorder.SetColor(Color), IronXL.Cells.XlsCellFont.SetColor(Color), IronXL.Cells.XlsCellStyle.SetBackgroundColor(Color), IronXL.Cells.XlsxCellBorder.SetColor(Color), IronXL.Cells.XlsxCellFont.SetColor(Color), IronXL.Cells.XlsxCellStyle.SetBackgroundColor(Color), IronXL.Ranges.RangeBorder.SetColor(Color), IronXL.Ranges.RangeFont.SetColor(Color), IronXL.Ranges.RangeStyle.SetBackgroundColor(Color), IronXL.Styles.IBorder.SetColor(Color), IronXL.Styles.IFont.SetColor(Color), IronXL.Styles.IStyle.SetBackgroundColor(Color)
添加依賴到IronDrawing NuGet套件，以啟用在使用上述方法時，從System.Drawing.Color進行隱式轉換
新增方法 IronXL.Drawing.Images.Image.ToAnyBitmap()，從 Image 對象的字節數據創建 IronSoftware.Drawing.AnyBitmap 對象。
更新終端用戶許可協議條款和條件
IronXL.dll 現在已簽署

2022年8月

IronXL v2022.8.8357

2022年8月23日

版本 2022.8.8357

功能與升級

https://www.nuget.org/packages/IronXL.Excel/2022.8.8357

發布說明：

新增功能：可使用密碼加密和解密「.xlsx」，「.xlsm」和「.xltx」檔案。使用 WorkBook.SaveAs(字串 fileName, 字串 password)在儲存時使用提供的密碼加密工作簿的方法。使用 WorkBook.Load(字串檔名, 字串密碼)在載入工作簿時使用提供的密碼解密文件的方法。密碼也可以通過以下方式指定：
- 使用 WorkBook.Password 屬性（如果此屬性不為空，則在儲存時會加密該工作簿；如果為空，則不會加密）
- 使用SavingOptions物件的SavingOptions.Password屬性，當呼叫WorkBook.SaveAs(string fileName, SavingOptions options)方法時
- 使用 LoadingOptions 物件和 LoadingOptions.Password 屬性，呼叫 WorkBook.Load(string filename, LoadingOptions options) 方法。

若要檢查 WorkBook 物件在儲存時是否會被加密，請使用 WorkBook.IsEncrypted 布林屬性。可以通過將 WorkBook.IsEncrypted 設為 false 來關閉加密功能。(注意：通過將 WorkBook.IsEncrypted 設為 true 不能加密工作簿，這將在運行時引發異常，並要求指定密碼。).

將密碼設定為除了 ".xlsx"、".xlsm" 和 ".xltx" 以外類型的工作簿時，也會在執行時拋出異常，提醒用戶工作簿無法加密。

新增對 .NET 6.0 的支援
移除對 System.Common.Drawing 的依賴
移除對 .NET Framework 4.5 的支援。最低支援的 .NET Framework 版本現在為 4.6.2
重大變更：方法 WorkBook.SaveAs(string filename, string listDelimiter) 被重新命名為 WorkBook.SaveAsWithCustomDelimiter(string filename, string listDelimiter)，以消除 SaveAs(string filename, string listDelimiter) 和 SaveAs(string fileName, string password) 方法之間的歧義。
重大變更：IronXL.Drawing.Images.IImage.ToBitmap() 方法已被移除，因為 System.Common.Drawing 不再受支持。
重大更改：IronXL.Drawing.Images.IImage.ToImage() 方法現在返回 SixLabors.ImageSharp.Image 物件，用於取代已移除的 System.Common.Drawing 物件。
修正了一個在 XLSX 工作簿中設置的背景顏色未在 Excel 中渲染的錯誤。
修正了一個泰語區域設置引發的許可例外錯誤
修復了一個錯誤，即每次在 XLSX 工作簿中給新單元格分配 DateTime 值時，都會為每個單元格創建一個新的單元格樣式，這會使樣式表溢出並破壞最終文件，如果單元格數量超過 64000。
改善了使用 DateTime 值和格式創建大量儲存格的速度。例如，過去在單個工作表上創建包含 80,000 個 DateTime 值和格式的工作簿需要 25 秒，但現在只需不到 0.8 秒（實際性能將取決於程式碼執行的環境）。

2022年7月

IronXL v2022.7.7362

2022年7月13日

版本 2022.7.7362

功能與升級

https://www.nuget.org/packages/IronXL.Excel/2022.7.7362

發布說明：

新增了一種更改儲存格字串值的方法，而不會自動格式化儲存格：這是通過 Cell 的 StringValue 屬性實現的。
在 Row 和 WorkSheet 中新增 AutoSizeRow 方法，調整列高以適應內容。
將 AutoSizeColumn 方法新增到 Column 和 WorkSheet，以調整行的寬度以適應內容
修復了添加或更改邊框時拋出異常的錯誤
修復了一個當儲存格的值被更改為依賴單個儲存格的公式時，例如 "=A1"，會引發異常的錯誤。
修正了一個錯誤，當將類似於 "12-720" 的字串新增到儲存格時，被解析為年份 720 的日期。Excel 不支援早於年份 1900 的日期。類似的字串將不再被解析為日期。然而，可以解析為 1900 年後的有效日期的字串仍會被解析為日期。例如 "12-1956"。使用 StringValue 屬性來繞過這個解析。
修復了一個錯誤，當加載、修改並保存現有工作簿時：單元格在其內容更改時可能會失去原始格式。現在不再會發生這種情況。