IronXL for .NET Excel 庫更新日誌

功能和升級

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

發行說明

更新

• 更新內部相依性。

功能和升級

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

發行說明

錯誤修正

• 修正了將數值儲存格錯誤地偵測為日期時間的問題。
• 修正了將 XLSX 轉換為 XLS 格式時資料類型損壞的問題。
• 修正了 AutoSizeColumn 方法高估列寬的問題。

功能和升級

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

發行說明

Updates

• 將IronSoftware.System.Drawing更新至 2025.9.3。

功能和升級

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

發行說明

Updates

• 將IronSoftware.System.Drawing更新至 2025.8.1。

功能和升級

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

發行說明

更新

• 將IronSoftware.System.Drawing更新至 2025.7.12。

功能和升級

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

發行說明

Updates:

• 將IronSoftware.System.Drawing更新至 2025.6.2。

錯誤修復：

• 修正了LastFilledCell屬性在資料稀疏的工作表中錯誤地傳回 null 的問題。
• 修正了為不同工作表新增表格時， CreateNamedTable會損壞 Excel 檔案的問題。

功能和升級

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

發布說明：

Updates

• 將IronSoftware.System.Drawing更新至 2025.5.3。
• 將IronSoftware.Common更新至 2025.3.1。

錯誤修正

• 修正了當 Excel 檔案包含超過 500 行時， Rows.Length傳回錯誤值的問題。

功能和升級

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

發布說明：

• 將IronSoftware.System.Drawing更新至版本 2025.3.6。
• 將IronSoftware.Common更新至 2025.3.1 版本。

功能和升級

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

發布說明：

• 將IronSoftware.System.Drawing更新至版本 2025.3.5。
• 將IronSoftware.Common更新至 2025.2.3 版本。

功能和升級

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

發布說明：

• 將IronSoftware.System.Drawing更新至 2025.1.6。

功能和升級

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

發布說明：

• 將IronSoftware.Common更新至 2024.11.4。
• 更新了依賴套件，以解決已知的安全漏洞。
• 修正了載入和儲存 .xlsm 檔案時拋出異常的問題。
• 修正了載入 Excel 檔案時出現"等效部件名稱"異常的問題。
• 修正了新增行時公式出錯的問題。
• 修正了載入資料驗證無效的 Excel 檔案時拋出異常的問題。
• 修正了設定數字格式時產生的 HTML 字體顏色為白色的問題。

功能和升級

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

發布說明：

• 將IronSoftware.System.Drawing更新至 2024.12.3。
• 將IronSoftware.Common更新至 2024.11.2。
• 提高了檢索單元格範圍的效能（對於中等到大型文件，速度提高了 5-10 倍）。
• 透過快取評估結果，改進了公式評估。
• 修正了載入某些檔案時發生的空引用異常。
• 修正了從公式中檢索日期值的問題。
• 增加了將不同格式的Workbook和Worksheet轉換為串流的功能。

功能和升級

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

發布說明：

• 將IronSoftware.System.Drawing更新至 2024.9.15
• 將IronSoftware.Common更新至 2024.9.38 版本
• 增加了將列方向切換為從右到左的支持，這對於阿拉伯語、中文和希伯來語等語言非常有用。
• 新增了使用SetWorksheetTabColor和SetWorksheetTabColorIndex設定選項卡顏色的方法。
• 新增了RemoveHyperlink方法，用於從儲存格中刪除超連結。
• 修正了當儲存格沒有超連結時，存取儲存格的超連結會引發空引用異常的問題。
• 修正了在存取 XLS 檔案中的檔案類型超連結時傳回空字串的問題。
• 修正了ToDataTable方法無法準確計算所有資料類型的問題。

功能和升級

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

發布說明：

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

功能和升級

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

發布說明：

• 修復了一些小錯誤

功能和升級

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

發布說明：

• 修復了一些小錯誤

功能和升級

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

發布說明：

• 修復了一些小錯誤

功能和升級

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

發布說明：

• 修復了一些小錯誤

功能和升級

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

發布說明：

• 修復了一些小錯誤
• 將IronSoftware.System.Drawing更新至版本 2024.5.1

功能和升級

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

發布說明：

• 修正了儲存檔案時"共用"公式（在多個儲存格中複製的公式）會遺失的錯誤。
• 將IronSoftware.System.Drawing更新至版本 2024.4.1

功能和升級

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 檔案中讀取許可證金鑰的錯誤。

功能和升級

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類，用於表示單元格註釋，並為所有註釋屬性提供 setter 和 getter 方法。
• 為IronXL.Cell類別新增Comment屬性，並新增了新增和刪除註解的方法。 如果儲存格沒有註釋，則Comment屬性為null 。 預設情況下，評論是不可見的。

功能和升級

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

發布說明：

• 進行了一些小改進並修復了一些錯誤

功能和升級

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

發布說明：

• 修正了建立已定義名稱時拋出異常的錯誤。
• 修正了載入包含圖表工作表的電子表格時出現錯誤的問題。 請注意，圖表仍不會載入。 支援圖表表格仍然是一個功能請求。
• 新增了將命名表轉換為DataTables功能。
• 新增了對資料驗證的支援：
  • WorkSheet中新增了DataValidations屬性。 它包含了工作表中的所有資料驗證，並包含了新增和刪除資料驗證的方法。
  • 可以從電子表格中讀取所有資料驗證類型。
  • 可以將WholeNumber 、 Decimal 、 TextLength 、 Date 、 List和FormulaList資料驗證新增至WorkSheet 。

功能和升級

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

發布說明：

IronDrawing 已更新至 2023.11.1 版本

• 修復了一些小問題並進行了改進 IronXL.Logger類別已棄用。 請改用IronSoftware.Logger 。

功能和升級

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

發布說明：

IronDrawing 已更新至 2023.10.2 版本

• 新增了對 IronSoftware.Common 2023.10.2 的依賴。
• 修復了一些小問題並進行了改進

功能和升級

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

發布說明：

IronDrawing 已更新至 2023.9.2 版本

• 穩定性提升
• 在某些情況下，效能提升可達執行速度提升 25%

功能和升級

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

發布說明：

• 一些小的改進和修復。
• 更新依賴項。

功能和升級

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

發布說明：

• 新增了GetMergedRegions方法，該方法用於檢索合併區域的清單。
• 修正了Clear方法無法刪除集合中的所有工作表的錯誤。
• 修正了InsertColumn方法跳過最後一行的錯誤。
• 修正了Range.ToDataTable方法在遇到空白行時停止轉換的錯誤。
• 將RemoveColumn方法組加入Range 、 RangeRow 、 RangeColumn 、 Worksheet 。
• InsertColumn方法組現在可以正確地將列移開，更新公式並隨單元格一起移動樣式。
• 在某些大量資料處理情況下，可將效能提升 20-25%。
• 已棄用Range.AllRowsInRange和Range.AllColumnsInRange屬性，請改用Range.Rows和Range.Columns 。 這對於WorkSheet 、 RangeRow和RangeColumn類別也是如此。
• 工作表的內部工作範圍現在會隨著對工作表所做的所有變更而正確更新。
• 工作表的內部工作範圍現在將包括範圍末尾的空列，這些空列包含任何樣式資訊。
• 修正了Range.Trim方法中的多個錯誤，包括Trim無法去除空列的錯誤。
• Range.RemoveColumn和Range.RemoveRow方法現在總是會從工作表中完全刪除列/行，如果刪除後列/行為空，則會將位於被刪除列/行下方/右側的行/列向上/向左移動。
• 新增了Range.Count屬性，該屬性傳回範圍內的儲存格數量，而無需遍歷所有儲存格。
• 變更Range.ColumnCount和Range.RowCount屬性，使其傳回區域中的列數/行數，而無需遍歷所有儲存格。
• 改進 Range 類別及其繼承者的文檔。
• InsertRow和InsertColumn方法現在將傳回插入的行/列。 InsertRows和InsertColumns方法也是如此，但它們會傳回已插入的列/行的清單。
• 當範圍改變時（使用Trim / Insert / Remove / Subtract方法），範圍的位址將會正確更新。
• 新增WorkSheet.RangeAddress屬性，其中包含工作表上正在使用的區域的位址。
• 將IronSoftware.System.Drawing更新至版本 2023.7.1

功能和升級

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

發布說明：

• 新增SetBorderStyle方法，用於設定邊框類型和顏色。
• 修正了圖表序列中的"&"符號在儲存後會導致產生的檔案損壞的錯誤。
• 修正了當 .xlsx（.xlsm、.xltx 等）檔案的內部 XML 結構中包含開始和結束的 br 標籤時， WorkBook.Load方法會拋出異常的錯誤。
• 將 IronDrawing 依賴項更新至 2023.6.1 版本。

功能和升級

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

發布說明：

• 修正了某些 .NET Framework ASP.NET 專案中無法從 web.config 檔案中擷取授權金鑰的問題
• 修正了有關 System.Memory 版本衝突的潛在警告

功能和升級

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

發布說明：

• 新增對 Iron Suite 許可證金鑰的支援
• 修正了 IronXL 無法辨識儲存在 .config 和 .json 檔案中的授權金鑰的問題
• 增加了對儲存在應用程式子資料夾中的 .config 和 .json 檔案中的許可證金鑰的支援。

功能和升級

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

發布說明：

• 在安裝 NuGet 套件之前，必須同意最終使用者授權協議 (EULA) 條款。
• 改進了 Range 類別的 IntelliSense 描述
• 修正了當工作表中不存在任何列時存取WorkSheet.PhysicalColumnCount屬性會引發異常的錯誤
• 改進Cell.Hyperlink屬性的 IntelliSense 描述
• 修正了在某些情況下設定Cell.Hyperlink屬性時會偵測到錯誤的超連結類型的錯誤。
• 改進了當系統中找不到任何字體時使用AutoSizeRow / AutoSizeColumn方法所發生的異常的描述
• 更新依賴項

功能和升級

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

發布說明：

• 用於WorkSheet.InsertImage方法的枚舉已更改為IronXL.Drawing.Images.ImageFormat
• 修正了在不同語言環境下，由於小數分隔符號的原因，圖表可能出現損壞的錯誤。
• 性能提升

功能和升級

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

發布說明：

• 修正了使用 IronXL 的應用程式在 Visual Studio 偵錯器掛鉤的情況下運行時拋出Licensing錯誤。
• 修正了刪除多個圖表中的一個，然後再新增另一個圖表時會拋出異常的錯誤。
• 圖表標題將不再覆蓋圖表區域。

功能和升級

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 物件時。 這適用於從 Range 繼承的所有物件（ WorkSheet 、 RangeRow等）。

功能和升級

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

發布說明：

• 為WorkBook載入方法新增重載，以接受加密 XLSX、XLSM 和 XLTX 工作簿的密碼。 新增重載函數的完整列表：
  • TryLoad(string filename, string password, out WorkBook workBook)
  • 載入(byte[] data, string password)
  • Load(Stream stream, string password)
  • LoadExcel(byte[] data, string password)
  • LoadExcel(Stream file, string password)
  • LoadExcel(字串檔名，字串密碼)
  • FromByteArray(byte[] data, string password)
  • FromStream(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%。

功能和升級

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 。

功能和升級

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

發布說明：

• 修正了上一版本中一些方法被錯誤混淆的問題。 受影響的方法清單： 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 已簽署。

功能和升級

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

發布說明：

• 新增使用密碼加密和解密".xlsx"、".xlsm"和".xltx"檔案的功能。 使用WorkBook.SaveAs(string fileName, string password)方法，在儲存WorkBook時使用提供的密碼對其進行加密。 載入工作簿時，使用WorkBook.Load(string filename, string password)方法，透過提供的密碼解密檔案。 密碼也可以透過以下方式指定：
  • 使用WorkBook.Password屬性（如果此屬性不為空，則儲存時工作簿將被加密；如果此屬性為空，則不會加密）
  • 在呼叫WorkBook.SaveAs(string fileName, SavingOptions options)方法時，使用帶有SavingOptions.Password屬性的SavingOptions物件。
  • 使用帶有LoadingOptions.Password屬性的LoadingOptions對象，呼叫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，則會導致產生的檔案損壞。
• 提高了創建大量具有日期時間值和格式的單元格的速度。 例如，先前在單一工作表中建立包含 80K 個日期時間值和格式儲存格的工作簿需要 25 秒，現在只需不到 0.8 秒（實際效能取決於程式碼執行的環境）。

功能和升級

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

發布說明：

• 新增了一種更改單元格字串值而不自動格式化單元格的方法：這是透過 Cell 的StringValue屬性實現的。
• 為Row和WorkSheet添加AutoSizeRow方法，該方法會改變行的高度以適應內容。
• 為Column和WorkSheet添加AutoSizeColumn方法，該方法會改變行的寬度以適應內容。
• 修正了新增或變更邊框時拋出異常的錯誤。
• 修正了一個錯誤，當儲存格值變更為依賴單一儲存格的公式時（例如"=A1"），會拋出例外。
• 修正了一個錯誤，即當將類似"12-720"的字串新增至儲存格時，該字串會被解析為 720 年的日期。 Excel 不支援 1900 年之前的日期。像這樣的字串不再被解析為日期。 但是，1900 年之後可以解析為有效日期的字串仍將被解析為日期。 例如"12-1956"。 使用StringValue屬性可以繞過此解析過程。
• 修正了一個錯誤，即載入、變更和儲存現有工作簿時，儲存格的內容變更後可能會遺失原始格式。 情況已不再如此。

功能和升級

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

發布說明：

• 新增一個新的IronXL.Formatting.ConditionType 。
• 舊版IronXL.Formatting.Enums.ConditionType已過時。
• 新增了對"格式化為表格"樣式的支援。
• 修正了透過 IronXL 載入包含透視表的檔案並儲存後，產生的檔案損壞的錯誤。
• 修正了複製貼上某個範圍後，儲存工作簿時產生的檔案損壞的錯誤。
• 修正了載入包含特定圖表類型的檔案並儲存後產生的檔案損壞的錯誤。
• 修正了載入包含 .bmp 映像的文件，但無法透過程式碼存取 .bmp 映像的錯誤。
• 修正了建立包含任何大量已使用儲存格的工作簿時，儲存後產生的檔案會損壞的錯誤。
• 修復了一些其他罕見的錯誤，這些錯誤偶爾可能會導致檔案損壞。
• 修正了對一系列儲存格套用樣式變更時耗時過長的問題。樣式變更包括字型變更（高度、粗體等）、垂直對齊方式、水平對齊方式等。
• 提高了產生檔案的整體穩定性，包括使用 IronXL 建立的檔案以及由 IronXL 匯入和編輯的檔案。
• 大大提高了效能，以前生成一個包含 10000 個已使用單元格的檔案需要 1.5 分鐘，現在只需 20 秒（具體時間取決於您的程式碼對單元格執行的操作）。

功能和升級

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

發布說明：

• 改進：支援 .NET 6
• 提升：速度和穩定性

功能和升級

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

發布說明：

• 改進：支援 .NET 5 和 .NET 6 測試版
• 提升：速度和穩定性
• 改進：日誌記錄

功能和升級

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

發布說明：

• 改進：支援 .NET 5 和 .NET 6 測試版
• 錯誤修復：許可證密鑰驗證現在不會包含空格。
• 提升：速度和穩定性

功能和升級

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

發布說明：

• 問題已修復：現在可與 .NET 5.07 相容
• 已修正錯誤：從專案設定檔讀取許可證金鑰（特殊情況）
• 提升：速度和穩定性