IronXL for .NET Excel 庫更新日誌

功能與升級

NuGet

發行說明

更新

• 更新內部相依性。

功能與升級

NuGet

發行說明

更新

• 更新內部相依性。

功能與升級

NuGet

發行說明

更新

• 更新內部相依性。

功能與升級

NuGet

發行說明

更新

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

功能與升級

NuGet

發行說明

更新

• 更新內部相依性。

功能與升級

NuGet

發行說明

錯誤修復

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

功能與升級

NuGet

發行說明

Updates

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

功能與升級

NuGet

發行說明

Updates

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

功能與升級

NuGet

發行說明

更新

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

功能與升級

NuGet

發行說明

更新：

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

錯誤修復：

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

功能與升級

NuGet

發布說明：

更新

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

錯誤修復

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

功能與升級

NuGet

發布說明：

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

功能與升級

NuGet

發布說明：

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

功能與升級

NuGet

發布說明：

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

功能與升級

NuGet

發布說明：

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

功能與升級

NuGet

發布說明：

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

功能與升級

NuGet

發布說明：

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

功能與升級

NuGet

發布說明：

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

功能與升級

NuGet

發布說明：

• 修復了一些小錯誤

功能與升級

NuGet

發布說明：

• 修復了一些小錯誤

功能與升級

NuGet

發布說明：

• 修復了一些小錯誤

功能與升級

NuGet

發布說明：

• 修復了一些小錯誤

功能與升級

NuGet

發布說明：

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

功能與升級

NuGet

發布說明：

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

功能與升級

NuGet

發布說明：

• 將 IronSoftware.Common 更新至 2024.1.7 版本
• 將 IronSoftware.System.Drawing 更新至 2024.3.4 版本
• 修正了.NET Framework中無法從 web.config 檔案中讀取許可證金鑰的錯誤。

功能與升級

NuGet

發布說明：

• 將 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。 預設情況下，評論是不可見的。

功能與升級

NuGet

發布說明：

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

功能與升級

NuGet

發布說明：

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

功能與升級

NuGet

發布說明：

IronDrawing 已更新至 2023.11.1 版本

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

功能與升級

NuGet

發布說明：

IronDrawing 已更新至 2023.10.2 版本

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

功能與升級

NuGet

發布說明：

IronDrawing 已更新至 2023.9.2 版本

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

功能與升級

NuGet

發布說明：

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

功能與升級

NuGet

發布說明：

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

功能與升級

NuGet

發布說明：

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

功能與升級

NuGet

發布說明：

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

功能與升級

NuGet

發布說明：

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

功能與升級

NuGet

發布說明：

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

功能與升級

NuGet

發布說明：

用於 WorkSheet.InsertImage 方法的枚舉已更改為 IronXl.Drawing.Images.ImageFormat

• 修正了在不同語言環境下，由於小數分隔符號的原因，圖表可能出現損壞的錯誤。
• 性能提升

功能與升級

NuGet

發布說明：

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

功能與升級

NuGet

發布說明：

• 修正了一個錯誤，該錯誤是由於文件中未索引的顏色導致 WorkBook.ExportToHtml 拋出異常。
• 修正了一個錯誤，即對 RangeStyle、@@--CODE-1079--v--CODE-1079--DE@CO時，會不必要地建立範圍內的所有儲存格。
• 修正了使用特定 WebPublishing 設定載入 .XLSX 檔案時拋出異常的錯誤。
• 新增 WorkSheet.PhysicalColumnCount 和 WorkSheet.PhysicalRowCount 屬性，傳回目前工作表中實際存在的行數和列數。
• 改進和更新 IntelliSense 文檔，以澄清 WorkSheet 和 Range 的一些屬性和方法。
• 提高讀取 Range 物件的任何屬性時的效能，尤其是在處理大範圍屬性時。 這適用於從 Range 繼承的所有物件（RangeRow 等）。

功能與升級

NuGet

發布說明：

• 為 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%。

功能與升級

NuGet

發布說明：

• 修正了最初建立的 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。

功能與升級

NuGet

發布說明：

• 修正了上一版本中一些方法被錯誤混淆的問題。 受影響的方法清單：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), @@-CODE-1109--CODE-1109--DE, @@CO@10 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.IBorder.SetColor(Color), IronXl.Styles.IFont.SetColor(Color)@, @@CO11111.
• 新增對 IronDrawing NuGet套件的依賴，以便在使用上面列出的方法時啟用從 System.Drawing.Color 的隱式轉換。
• 新增一個方法 IronXl.Drawing.Images.Image.ToAnyBitmap()，該方法從 Image 物件的位元組資料建立一個 IronSoftware.Drawing.AnyBitmap 物件。
• 更新最終使用者授權協議條款和條件。
• IronXL已簽署。

功能與升級

NuGet

發布說明：

• 新增使用密碼加密和解密".xlsx"、".xlsm"和".xltx"檔案的功能。 儲存時，請使用 WorkBook.SaveAs(string fileName, string password) 方法，並使用提供的密碼對 WorkBook 進行加密。 載入工作簿時，使用提供的密碼解密檔案。 密碼也可以透過以下方式指定：
  • 使用 WorkBook.Password 屬性（如果此屬性不為空，則儲存時工作簿將被加密；如果此屬性為空，則不會加密）
  • 使用帶有 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) 方法之間的歧義。
• 重大變更：由於 System.Common.Drawing 不再受支持，因此刪除了 IronXl.Drawing.Images.IImage.ToBitmap() 方法。
• 重大變更：IronXl.Drawing.Images.IImage.ToImage() 方法現在傳回一個 SixLabors.ImageSharp.Image 對象，用作已移除的 System.Common.Drawing 物件的替代品。
• 修正了 XLSX 工作簿中儲存格或區域的背景顏色在 Excel 中無法呈現的錯誤。
• 修正了泰語區域設定拋出許可證異常的錯誤
• 修正了 XLSX 工作簿中每次為新儲存格指派 DateTime 值時都會為每個儲存格建立一個新的儲存格樣式的錯誤，導致樣式表溢出，如果儲存格數量超過 64000，則會導致產生的檔案損壞。
• 提高了創建大量具有日期時間值和格式的單元格的速度。 例如，先前在單一工作表中建立包含 80K 個日期時間值和格式儲存格的工作簿需要 25 秒，現在只需不到 0.8 秒（實際效能取決於程式碼執行的環境）。

功能與升級

NuGet

發布說明：

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

功能與升級

NuGet

發布說明：

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

功能與升級

NuGet

發布說明：

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

功能與升級

NuGet

發布說明：

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

功能與升級

NuGet

發布說明：

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

功能與升級

NuGet

發布說明：

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