IronXL for .NET Excel 库更新日志。

功能与升级

https://www.nuget.org/packages/IronXL.Excel/2025.12.2。

发布说明

更新

• 当加载某些包含数据验证记录的.xls文件时，修正了InvalidCastException。

功能与升级

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

发布说明

更新

• 更新内部依赖项。

功能与升级

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

发布说明

错误修复

• 修正了将数字单元格错误地检测为 DateTime 的问题。
• 修复了将 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。

发布说明

更新：

• 更新 IronSoftware.System.Drawing 至 2025.6.2。

错误修复：

• 修复了一个问题，即对于数据稀疏的工作表，LastFilledCell 属性会错误地返回空值。
• 修复了 CreateNamedTable 在将表格添加到不同工作表时损坏 Excel 文件的问题。

功能与升级

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

发布说明：

更新

• 将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。

发布说明：

• 修复了一个 Bug，该 Bug 在保存文件时会丢失 "共享 "公式（在多个单元格中复制的那种）。
• 更新 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类以表示单元格注释，并为所有注释属性提供设置器和获取器
• 为 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类已废弃。 请使用 Iron Software.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 方法在遇到空行时停止转换的错误。
• 为 Range, RangeRow, RangeColumn, Worksheet 添加 RemoveColumn 方法组。
• 现在，InsertColumn 方法组将正确移动列，更新公式并移动单元格样式。
• 在某些情况下，批量数据处理的时间性能可提高 20-25%。
• 弃用 Range.AllRowsInRange 和 Range.AllColumnsInRange 属性，改用 Range.Rows 和 Range.Columns 属性。 对于 WorkSheet, RangeRow 和 RangeColumn 类也是如此。
• 现在，WorkSheet 的内部工作范围将随工作表的所有更改而正确更新。
• WorkSheet 的内部工作范围现在将包括范围末尾的空列，其中包含任何样式信息。
• 修正了 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 条款
• 改进范围类的 IntelliSense 描述
• 修复了一个 Bug，当在工作表中不存在列时访问 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。

发布说明：

• 修复了一个 Bug，当使用 IronXL 的应用程序与 Visual Studio 调试器挂钩执行时，会出现 Licensing 异常。
• 修复了删除多个图表中的一个，然后再添加另一个图表时会出现异常的错误。
• 图表标题将不再覆盖图表区域。

功能与升级

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

发布说明：

• 修复了一个 Bug，在该 Bug 中，WorkBook.ExportToHtml 会因文档中未索引的颜色而产生异常。
• 修正了一个错误，即对 Range, WorkSheet, RangeRow, RangeColumn, RangeStyle, RangeFont 和 RangeBorder 属性的 getter 调用将不必要地创建区域中的所有单元格。
• 修正了一个错误，即在加载具有特定 WebPublishing 设置的 .XLSX 文件时会出现异常。
• 添加WorkSheet.PhysicalColumnCount和WorkSheet.PhysicalRowCount属性，返回当前工作表中实际存在的行数和列数。
• 改进和更新 IntelliSense 文档，以阐明 WorkSheet 和 Range 的某些属性和方法。
• 提高读取 Range 对象的任何属性时的性能，尤其是在大型 Ranges 的情况下。 这适用于从 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)
  • 加载（字节 [] 数据，字符串密码）
  • 加载（流媒体流、字符串密码）
  • LoadExcel(byte [] data, string password)
  • 加载 Excel（流文件，字符串密码）
  • 加载 Excel（字符串文件名，字符串密码）
  • 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 时，某些边框样式会导致异常。
• 修复了一个 Bug，即如果在最后一行的位置插入行，InsertRow 方法会产生异常。
• 提高 AutoSizeRow 和 AutoSizeColumn 方法的精度。
• 将 InsertRow 方法的性能提高 25%。

功能与升级

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

发布说明：

• 修复了一个错误，该错误导致首次创建的 ConditionalFormattingRule 无法正常工作。
• 修正了一个错误，即字体颜色没有被条件格式化规则应用。
• 修复了在 .xlsx 中更改 Cell.FormatString 属性时创建重复样式的错误。
• 修正了一个 Bug，在该 Bug 中，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.XlsxCellStyle.SetBackgroundColor(Color)</代码>, <代码>IronXL.Ranges.RangeBorder.SetColor(Color)</代码>, <代码>IronXL.Ranges.RangeFont.SetColor(Color)</代码>, <代码>IronXL.Ranges.RangeStyle.SetBackgroundColor(Color)</代码>.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 对象的字节数据创建 Iron Software.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 对象。
  • 在调用 WorkBook.Load(string filename, LoadingOptions options) 方法时，使用带有 LoadingOptions.Password 属性的 LoadingOptions 对象。
• 要检查 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对象。
• 修正了一个 Bug，在该 Bug 中，为 XLSX 工作簿中的单元格或区域设置的背景颜色无法在 Excel 中呈现。
• 修复了泰语语言区会导致许可证异常的错误
• 修复了一个 Bug，即在 XLSX 工作簿中，每次为新单元格分配 DateTime 值时，都会为每个单元格创建新的单元格样式，从而导致样式表溢出，如果单元格数大于 64000，则会破坏生成的文件。
• 提高创建具有 DateTime 值和格式的大量单元格的速度。 例如，在单个工作表上创建一个包含 80K DateTime 值和格式单元格的工作簿过去需要 25 秒，现在只需不到 0.8 秒（实际性能取决于代码执行的环境）。

功能与升级

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

发布说明：

• 添加了一种在不自动格式化单元格的情况下更改单元格字符串值的方法：这是通过单元格的 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 兼容
• 已修复错误：从项目配置文件中读取许可证密钥（特殊情况）
• 提升：速度和稳定性