IronXL for .NET Excel 程式庫更新日誌

版本說明

• 新增支援 40 多個現代 Excel _xlfn.* 函式，提升 Microsoft 365 工作簿的 EvaluateAll() 相容性
• 更新內部依賴項

版本說明

• 在 XLSX 載入過程中減少 65-80% 的峰值記憶體使用量，提高了在受限環境中的大型檔案的可靠性
• 更新內部依賴項

版本說明

• 修復了在大型試算表上應用樣式極慢的問題（現在快了 25-393 倍）。 以前需要幾分鐘才能完成的對 500K 以上單元格範圍的操作，現在在毫秒內完成。

版本說明

• 更新內部依賴項。

版本說明

• 更新內部依賴項。

版本說明

• 更新內部依賴項。

版本說明

• 修復了在載入某些包含資料驗證記錄的InvalidCastException檔案時出現的問題。

版本說明

• 更新內部依賴項。

版本說明

• 修正了一個問題，即數字型單元格被錯誤地檢測為DateTime。
• 修正了一個問題，即將 XLSX 轉換為 XLS 格式時資料型別被損壞。
• 修正了一個問題，即AutoSizeColumn方法高估了列寬。

版本說明

• 更新IronSoftware.System.Drawing至2025.9.3。

版本說明

• 更新IronSoftware.System.Drawing至2025.8.1。

版本說明

• 更新IronSoftware.System.Drawing至2025.7.12。

版本說明

更新:

• 更新IronSoftware.System.Drawing至2025.6.2。

錯誤修正:

• 修正了一個問題，即針對稀疏資料的工作表LastFilledCell屬性返回了空值。
• 修正了一個問題，即當不同工作表中新增表格時CreateNamedTable會損壞 Excel 檔案。

版本說明

• 更新IronSoftware.System.Drawing至2025.5.3。

• 更新IronSoftware.Common至2025.3.1。

• 修正了一個問題，即使用 Excel 檔案超過 500 行時Rows.Length返回了錯誤的值。

版本說明

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

版本說明

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

版本說明

• 更新IronSoftware.System.Drawing至2025.1.6。

版本說明

• 更新IronSoftware.Common至2024.11.4。
• 更新依賴套件以解決已知的安全漏洞。
• 修正了一個問題，即載入和保存 .xlsm 檔案拋出異常。
• 修正了一個問題，即載入 Excel 檔案時出現"等效部件名稱"異常。
• 修正了一個問題，即新增行後公式損壞。
• 修正了一個問題，即載入包含無效資料驗證的 Excel 檔案時拋出異常。
• 修正了一個問題，即設置數字格式時生成的 HTML 字體顏色變成白色。

版本說明

• 更新IronSoftware.System.Drawing至2024.12.3。
• 更新IronSoftware.Common至2024.11.2。
• 提高了檢索單元格範圍的性能（中大型檔案快了5-10倍）。
• 通過快取評估結果來改進公式評估。
• 修正了在載入某些檔案時出現的空引用異常。
• 修正了從公式檢索日期值的問題。
• 新增了將Worksheet以不同格式作為流進行轉換的功能。

版本說明

• 更新IronSoftware.System.Drawing至2024.9.15
• 更新IronSoftware.Common至2024.9.38
• 新增了切換列方向至從右到左的支援，用於如阿拉伯語、中文和希伯來語等語言。
• 新增了可以使用SetWorksheetTabColorIndex設定標籤顏色的方法。
• 新增了RemoveHyperlink方法以移除單元格中的超連結。
• 修正了一個問題，即如果單元格沒有超連結，存取其超連結會拋出空引用異常。
• 修正了一個問題，即在 XLS 檔案中存取文件型別超連結時返回空字串。
• 修正了一個問題，即ToDataTable方法未正確計算所有資料型別。

版本說明

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

版本說明

• 小錯誤修正

版本說明

• 小錯誤修正

版本說明

• 小錯誤修正

版本說明

• 小錯誤修正

版本說明

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

版本說明

• 修復了一個錯誤，即在儲存文件時，會丟失"共享"公式（是指複製到多個單元格的那種）。
• 更新 IronSoftware.System.Drawing 至版本 2024.4.1

版本說明

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

版本說明

• 更新 IronSoftware.Common 至版本 2024.1.2
• 修復了一個錯誤，即從 DataSets 載入資料的方法（特別是 LoadWorkSheetsFromDataSet 方法）執行速度非常慢
• 因上述修正，對許多其他建立大量單元格的方法進行了性能改進
• 修復了一個錯誤，即對單元格進行任何樣式更改會導致單元格前景色設為黑色
• IronXL.Cell.Int64Value 和 IronXL.Cell.Int32Value 方法已過時，未來將被移除。 請改用 IronXL.Cell.IntValue 和 IronXL.Cell.LongValue
• 新增 IronXL.Cells.Comment 類別，用於表示單元格評論，具有所有評論屬性的設定器和獲取器
• 在 IronXL.Cell 類別中新增 Comment 屬性，帶有新增和刪除評論的方法。 如果單元格沒有評論，則 Comment 屬性是 null。 評論預設情況下以不可見形式新增

版本說明

• 輕微改進和錯誤修復

版本說明

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

版本說明

• IronDrawing 已更新到版本 2023.11.1
• 輕微修復和改進
• IronXL.Logger 類別已被淘汰。 請改用 IronSoftware.Logger

版本說明

• IronDrawing 已更新到版本 2023.10.2
• 新增依賴 IronSoftware.Common 2023.10.2
• 輕微修復和改進

版本說明

• IronDrawing 已更新到版本 2023.9.2
• 穩定性改進
• 性能改進，在某些情況下執行時間提高了 25%

版本說明

• 輕微改進和修復。
• 更新了依賴項。

版本說明

• 新增 GetMergedRegions 方法，用於檢索合併區域的列表。
• 修復了一個錯誤，Clear 方法未刪除集合中的所有工作表。
• 修復了一個錯誤，InsertColumn 方法跳過了最後一行。
• 修復了一個錯誤，Range.ToDataTable 方法遇到空行時停止轉換。
• 向 RemoveColumn 方法組新增了 Worksheet。
• 現在，InsertColumn 方法組會正確地將欄位移開，更新公式並將樣式與單元格一起移動。
• 在某些批量資料操作情況下，性能提升 20-25%。
• 淘汰 Range.AllRowsInRange 和 Range.AllColumnsInRange 屬性，請改用 Range.Rows 和 Range.Columns。 這對於 RangeRow 和 RangeColumn 類別也是如此。
• WorkSheet 的內部工作範圍將會正確地隨著對工作表的所有更改而更新。
• WorkSheet 的內部工作範圍將會包括範圍末端的空列，這些空列保存任何樣式資訊。
• 修復 Range.Trim 方法中的多個錯誤，包括一個錯誤，Trim 不修整空列。
• 現在 Range.RemoveColumn 和 Range.RemoveRow 方法將總是從表中完全移除欄/行，如果在移除後欄/行是空的，則向上/向左移動位於其下方/右側的欄/行。
• 新增 Range.Count 屬性，返回範圍內的單元格數量，而不必遍歷所有單元格。
• 將 Range.ColumnCount 和 Range.RowCount 屬性更改為返回範圍內的列/行數量，而不必遍歷所有單元格。
• 改進範圍類及其繼承者的文件。
• 現在 InsertRow 和 InsertColumn 方法將返回插入的行/列。 對於 InsertRows 和 InsertColumns 方法也一樣，但這些方法將返回插入的列/行的列表。
• 範圍的地址在範圍更改時將被正確更新（使用 Subtract 方法）。
• 新增了 WorkSheet.RangeAddress 屬性，提供使用中區域在表上的地址。
• 更新 IronSoftware.System.Drawing 到版本 2023.7.1

版本說明

• 新增 SetBorderStyle 方法，用於設定邊框型別和顏色。
• 修復了一個錯誤，即圖表系列中的"&"符號在保存後會破壞結果文件。
• 修復了一個錯誤，即如果 .xlsx (.xlsm、.xltx 等) 文件在其內部 XML 結構中有一個開口和閉合的 br 標籤 - WorkBook.Load 方法將拋出異常。
• 更新 IronDrawing 依賴到版本 2023.6.1。

版本說明

• 修復了一個問題，即在某些 .NET Framework ASP.NET 專案中無法從 web.config 中檢索授權金鑰
• 修復了 System.Memory 版本衝突的可能警告

版本說明

• 新增對 Iron Suite 授權金鑰的支持
• 修復了授權金鑰儲存在 .config 和 .json 文件中時無法被 IronXL 辨識的問題
• 新增對應用程式子資料夾中的 .config 和 .json 文件中儲存的授權金鑰的支持

版本說明

• 安裝 nuget 套件前需同意 EULA 條款
• 改進 IntelliSense 描述，適用於 Range 類別
• 修復了在工作表中無列時存取 WorkSheet.PhysicalColumnCount 屬性會拋出異常的錯誤
• 改進 IntelliSense 描述，適用於 Cell.Hyperlink 屬性
• 修復了一個錯誤，當設置 Cell.Hyperlink 屬性時，某些情況下檢測到錯誤的超連結型別
• 當使用 AutoSizeColumn 方法，而系統中找不到字體時改進異常描述
• 更新依賴項

版本說明

• 用於 WorkSheet.InsertImage 方法的 Enum 更改為 IronXL.Drawing.Images.ImageFormat
• 修復了一個錯誤，即在不同區域設置下，由於小數分隔符，圖表可能會損壞
• 性能改進

版本說明

• 修復了在使用 IronXL 的應用程式執行並掛載了 Visual Studio 除錯器時，會拋出 Licensing 異常的錯誤。
• 修復了一個錯誤，即刪除多個圖表之一後再新增另一個圖表會拋出異常。
• 圖表標題不再會重疊圖表區域。

版本說明

• 修復了一個錯誤，其中WorkBook.ExportToHtml因文件中未索引的顏色導致拋出異常。
• 修復了一個錯誤，其中Range, WorkSheet, RangeRow, RangeColumn, RangeStyle, RangeBorder的屬性getter調用會不必要地建立範圍內的所有單元格。
• 修復了一個錯誤，在載入具有特定WebPublishing設置的.XLSX文件時拋出異常。
• 新增了WorkSheet.PhysicalRowCount屬性，這些屬性返回當前工作表中實際存在的行數和列數。
• 改進並更新了Range的屬性和方法。
• 改善了讀取任何Range物件屬性的性能，尤其是在處理大型範圍時。 這適用於所有從Range繼承的物件（如WorkSheet, RangeRow等）。

版本說明

• 為WorkBook載入方法新增了重載，以接受加密的XLSX, XLSM和XLTX工作簿的密碼。 新增的重載完整列表：
  • TryLoad(string filename, string password, out WorkBook workBook)
  • Load(byte [] data, string password)
  • Load(Stream stream, string password)
  • LoadExcel(byte [] data, string password)
  • LoadExcel(Stream file, string password)
  • LoadExcel(string filename, string password)
  • FromByteArray(byte [] data, string password)
  • FromStream(Stream stream, string password)
• 新增了一個方法MemoryStream。 僅支持XLSX, XLSM和XLTX型別的工作簿。
• 新增了一個方法MemoryStream。 僅支持XLSX, XLSM和XLTX型別的工作簿。
• 修復了一個錯誤，某些邊框樣式在將工作簿導出為HTML時引發異常。
• 修復了一個錯誤，如果在最後一行插入行，InsertRow方法會引發異常。
• 提高了AutoSizeColumn方法的精度。
• 提高了InsertRow方法的性能提高了25%。

版本說明

• 修復了一個錯誤，第一個建立的ConditionalFormattingRule無法正常運行。
• 修復了一個錯誤，字體顏色未通過條件格式規則應用。
• 修復了一個錯誤，當.xslx文件中更改Cell.FormatString屬性時建立了重複的樣式。
• 修復了一個錯誤，Range.Column(int)方法對於大範圍的執行可能需要幾分鐘的時間。
• 新增了枚舉IronXL.SortOrder，指示排序的方向（如果適用）。
• 新增了Range.SortByColumn(int, SortOrder)方法，允許按指定列對範圍進行排序，根據指定列的新順序重新排列範圍內的行。
• 移除了對IronDrawing nuget包的依賴，並用IronSoftware.System.Drawing取而代之。

版本說明

• 修復了前一個版本中錯誤模糊處理的若干方法的問題。 受影響的方法列表：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的隱式型別轉換。
• 新增了一個方法IronSoftware.Drawing.AnyBitmap對像。
• 更新了最終使用者授權協議條款和條件。
• IronXL.dll現在已簽名。

版本說明

• 增加了使用密碼加密和解密".xlsx"，".xlsm"和".xltx"文件的功能。 使用WorkBook並儲存。 使用WorkBook.Load(string filename, string password)方法在載入工作簿時用提供的密碼解密文件。 密碼也可以通過以下方式指定：
  • 使用WorkBook.Password屬性（如果這個屬性不為null，工作簿在保存時將被加密，如果為null則不會被加密）
  • 使用帶有WorkBook.SaveAs(string fileName, SavingOptions options)方法時
  • 使用帶有WorkBook.Load(string filename, LoadingOptions options)方法時
• 要檢查WorkBook.IsEncrypted布林屬性。 也可以將WorkBook.IsEncrypted = true，工作簿不能被加密，這會在運行時拋出異常，要求改為指定密碼）。
• 為非".xlsx"，".xlsm"和".xltx"型別的工作簿設定密碼也會在運行時拋出異常，警告使用者工作簿無法加密。
• 新增了對.NET 6.0的支持
• 移除了對System.Common.Drawing的依賴
• 移除了對.NET Framework 4.5的支持。現在最低支持的.NET Framework版本是4.6.2
• 重大變更：SaveAs(string fileName, string password)方法之間的歧義。
• 重大變更：System.Common.Drawing不再支持。
• 重大變更：SixLabors.ImageSharp.Image物件。
• 修復了一個錯誤，XLSX工作簿中設置為單元格或範圍的背景顏色未在Excel中呈現。
• 修復了一個錯誤，泰語語言區域拋出許可證異常
• 修復了一個錯誤，每次將DateTime值分配給XLSX工作簿中的一個新單元格時，都會為每個單元格建立一個新的單元格樣式，導致樣式表溢出，並當單元格數量超過64000個時破壞結果文件。
• 提高了建立大量具有DateTime值和格式的單元格的速度。 例如，在一個工作表上建立具有80K DateTime 值和格式的單元格的工作簿從前需要25秒，現在不到0.8秒（實際性能將依賴於程式碼運行的環境）。

版本說明

• 增加了一種不自動格式化單元格而更改單元格字串值的方法：這可以通過單元格的StringValue屬性實現。
• 向AutoSizeRow方法，這會改變行的高度以適應內容。
• 向AutoSizeColumn方法，這會改變行的寬度以適合內容。
• 修復了一個錯誤，當新增或更改邊框時引發異常。
• 修復了一個錯誤，當單元格值更改為依賴單個單元格的公式時引發異常，例如"=A1"。
• 修復了一個錯誤，類似於"12-720"的字串在新增到單元格時被解析為年份720的日期。 Excel不支持早於1900年的日期。這樣的字串不再被解析為日期。 然而，可以解析為1900年後有效日期的字串仍將被解析為日期。 例如"12-1956"。 使用StringValue屬性來跳過此解析。
• 修復了一個錯誤，當載入、改變並保存現有工作簿時：在更改內容時，單元格可能失去原始格式。 現在不再是這樣。

版本說明

• 新增了一個新的IronXL.Formatting.ConditionType。
• 舊的IronXL.Formatting.Enums.ConditionType已被廢棄。
• 新增了對"格式化為表格"樣式的支持。
• 修復了一個錯誤，含樞紐表的文件通過IronXL載入然後保存，結果文件損壞。
• 修復了一個錯誤，範圍被複製和粘貼，工作簿被保存，結果文件損壞。
• 修復了一個錯誤，因特定型別的圖表的文件載入然後保存，結果文件損壞。
• 修復了一個錯誤，含.bmp圖像的文件被載入，但.bmp圖像無法通過程式碼被存取。
• 修復了一個錯誤，建立超大量使用的單元格的工作簿然後保存，結果文件損壞。
• 修復了一些其他偶爾可能導致文件損壞的罕見錯誤。
• 修復了對一範圍的單元格應用了樣式改變時，耗費大量時間的問題。樣式更改包括字體（高度，粗細等），垂直對齊，水平對齊等的更改。
• 提高了使用IronXL建立並由IronXL導入和編輯的結果文件的整體穩定性。
• 大大提高了性能，生成一個含有10000個使用過的單元格的文件以前需要1.5分鐘，現在只需要20秒（具體時間將依賴於程式碼對單元格執行的操作）。

版本說明

• 改進：支持.NET 6
• 改進：速度和穩定性

版本說明

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

版本說明

• 改進：支持.NET 5和.NET 6測試版
• 錯誤修正：許可證密鑰驗證現在對空白格不敏感
• 改進：速度和穩定性

版本說明

• 錯誤修正：現在可以與.NET 5.07一起工作
• 錯誤修正：讀取來自專案配置文件的許可證密鑰（邊緣案例）
• 改進：速度和穩定性