IronXL 適用於 .NET Excel 庫更新日誌

發行說明

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

發行說明

• 減少XLSX加載期間的峰值內存使用量65-80%，提高了在受限環境中處理大文件的可靠性
• 更新了內部依賴項

發行說明

• 修正了在大型電子表格上應用樣式非常慢的問題（現在快25-393倍）。 在500K+單元格範圍上需要幾分鐘的操作現在以毫秒完成。

發行說明

• 更新內部相依性。

發行說明

• 更新內部相依性。

發行說明

• 更新內部相依性。

發行說明

• 修正了.xls文件時的問題。

發行說明

• 更新內部相依性。

發行說明

• 修正了一個問題，數字單元格被錯誤地識別為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屬性對於具有稀疏數據的工作表出現誤返回null。
• 修正了一個問題，CreateNamedTable當添加表格到不同的表頁時，會損壞Excel文件。

發行說明

• 更新IronSoftware.System.Drawing至2025.5.3。

• 更新IronSoftware.Com/mon至2025.3.1。

• 修正了一個問題，當與超過500行的Excel文件一起使用時，Rows.Length返回了一個不正確的值。

發行說明

• 更新IronSoftware.System.Drawing至版本2025.3.6。
• 更新IronSoftware.Com/mon至版本2025.3.1。

發行說明

• 更新IronSoftware.System.Drawing至版本2025.3.5。
• 更新IronSoftware.Com/mon至版本2025.2.3。

發行說明

• 更新IronSoftware.System.Drawing至2025.1.6。

發行說明

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

發行說明

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

發行說明

• 更新IronSoftware.System.Drawing至2024.9.15
• 更新IronSoftware.Com/mon至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.Com/mon至版本2024.1.7
• 更新IronSoftware.System.Drawing至版本2024.3.4
• 修正了 .NET Framework 中無法從 web.co/nfig 檔案中讀取許可證金鑰的錯誤。

發行說明

• 更新IronSoftware.Com/mon至版本2024.1.2
• 修正了一個錯誤，導致從LoadWorkSheetsFromDataSet方法）
• 由於上述修復，許多其他產生大量單元格的方法也獲得了效能提升。
• 修正了儲存格樣式變更會導致儲存格前景色變成黑色的錯誤。
• IronXl.Cell.Int32Value方法已過時，將在將來移除。 請改用IronXl.Cell.LongValue
• 添加IronXl.Cells.Com/ment類以表示單元格註釋，並設有所有註釋屬性的設置器和獲取器
• 向Comment屬性，其方法可以添加和移除註釋。 如果單元格沒有註釋，null。 預設情況下，評論是不可見的。

發行說明

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

發行說明

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

發行說明

IronDrawing 已更新至 2023.11.1 版本

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

發行說明

IronDrawing 已更新至 2023.10.2 版本

• 新增對 IronSoftware.Com/mon 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.Co/lumns。 這同樣適用於 RangeRow 和 RangeColumn 類別。
• WorkSheet 的內部工作範圍現在將隨著對工作表的所有更改而正確更新。
• WorkSheet 的內部工作範圍現在將包括範圍末端的空列，這些列包含樣式信息。
• 修正 Range.Trim 方法中的多個錯誤，包括 Trim 無法修剪空列的錯誤。
• Range.RemoveColumn 和 Range.RemoveRow 方法現在將始終從表中完全移除該列/行，並將位於已移除的行/列之下/右側的行/列向上/向左移動，如果在移除後該列/行為空。
• 新增 Range.Co/unt 屬性，該屬性返回範圍內的單元格數量，而無需遍歷所有單元格。
• 更改 Range.Co/lumnCount 和 Range.RowCount 屬性以返回範圍內的列/行數量，而無需遍歷所有單元格。
• 改進 Range 類別及其繼承者的文檔。
• 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.co/nfig 中檢索授權金鑰
• 修復可能的 System.Memory 版本衝突警告

發行說明

• 新增對 Iron Suite 許可證金鑰的支援
• 修正了 IronXL 無法辨識儲存在 .config 和 .json 檔案中的授權金鑰的問題
• 增加了對儲存在應用程式子資料夾中的 .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 因文件中的顏色未索引而拋出異常。
• 修正了一個錯誤，在某些情況下，對 RangeBorder 屬性的 getter 調用會不必要地創建範圍中的所有單元格。
• 修正了一個錯誤，通過特定 WebPublishing 設置加載 .XLSX 文件時拋出異常。
• 添加 WorkSheet.PhysicalColumnCount 和 WorkSheet.PhysicalRowCount 屬性，這些屬性返回當前工作表中實際存在的行和列的數量。
• 改進並更新 IntelliSense 文檔，以澄清某些 WorkSheet 和 Range 的屬性和方法。
• 改進讀取任何 Range 對象屬性的效能，特別是在範圍龐大的情況下。 這適用於所有從 Range 繼承的對象 (RangeRow，等等）。

發行說明

• 為 WorkBook 加載方法添加了重載，以接受加密 XLSX、XLSM 和 XLTX 工作簿的密碼。 新增重載函數的完整列表：
  • TryLoad(string filename, string password, out WorkBook workBook)
  • 載入(byte[] data, string password)
  • 載入(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)，該方法將使用提供的密碼解密流，並返回解密結果 MemoryStream。 僅支援 XLSX、XLSM 和 XLTX 類型的工作簿。
• 修正了將工作簿匯出為 HTML 時某些邊框樣式導致異常的錯誤。
• 修正了一個錯誤，該錯誤導致 InsertRow 方法會在插入行在最後一行的位置時拋出異常。
• 改進 AutoSizeRow 和 AutoSizeColumn 方法的精確度。
• 改進 InsertRow 方法的效能，提高 25%。

發行說明

• 修正了一個錯誤，第一次創建的 ConditionalFormattingRule 無法正常運作。
• 修正了條件格式規則無法套用字體顏色的錯誤。
• 修正了一個錯誤，在改變 .xlsx 中的 Cell.FormatString 屬性時創建了重複的樣式。
• 修正了一個錯誤，Range.Row(int) 和 Range.Co/lumn(int) 方法對大範圍可能需要幾分鐘的執行時間。
• 添加了一個枚舉 IronXl.SortOrder 來指示排序的方向（如果適用）。
• 添加 Range.SortByColumn(string, SortOrder) 和 Range.SortByColumn(int, SortOrder) 方法，允許按指定列對範圍進行排序，根據指定列的新順序重新排列要排序的範圍的行。
• 移除對 IronDrawing nuget 套件的依賴，並以 IronSoftware.System.Drawing 取代。

發行說明

• 修正了上一版本中一些方法被錯誤混淆的問題。 受影響的方法列表: IronXl.Styles.IStyle.SetBackgroundColor(Color)。
• 添加了一個依賴於 IronDrawing nuget 套件，以便在使用上述方法時，從 System.Drawing.Co/lor 進行隱式轉換。
• 添加了一個方法 IronXl.Drawing.Images.Image.ToAnyBitmap()，該方法從圖像對象的字節數據創建一個 IronSoftware.Drawing.AnyBitmap 對象。
• 更新最終使用者授權協議條款和條件。 IronXL.dll 已簽署。

發行說明

• 新增使用密碼加密和解密".xlsx"、".xlsm"和".xltx"檔案的功能。 使用 WorkBook.SaveAs(string fileName, string password) 方法在保存時使用提供的密碼加密 WorkBook。 使用 WorkBook.Load(string filename, string password) 方法在加載工作簿時使用提供的密碼解密文件。 密碼也可以透過以下方式指定：
  • 使用 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.Com/mon.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.Com/mon.Drawing 不再支持。
• 重大變更：IronXl.Drawing.Images.IImage.ToImage() 方法現在返回一個用於替代已移除的 System.Com/mon.Drawing 對象的 SixLabors.ImageSharp.Image 對象。
• 修正了 XLSX 工作簿中儲存格或區域的背景顏色在 Excel 中無法呈現的錯誤。
• 修正了泰語區域設定拋出許可證異常的錯誤
• 修正了一個錯誤，該錯誤導致每次為 XLSX 工作簿中的新單元格分配 DateTime 值時，為每個單元格創建一個新的單元格樣式，如果單元格數超過 64000，則樣式表溢出並破壞結果文件。
• 改進了創建大量具有 DateTime 值和格式的單元格的速度。 例如，在單個工作表中創建一個包含 80K 個 DateTime 值和格式的工作簿過去需要 25 秒，現在只需不到 0.8 秒（實際效能將取決於程式碼執行的環境）。

發行說明

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

發行說明

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

發行說明

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

發行說明

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

發行說明

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

發行說明

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