IronXL for .NET Excel 库更新日志

功能与升级

NuGet​

发布说明

更新

• 更新内部依赖项。

功能与升级

NuGet​

发布说明

更新

• 更新内部依赖项。

功能与升级

NuGet​

发布说明

更新

• 更新内部依赖项。

功能与升级

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

发布说明

更新

• 修复了加载某些包含数据验证记录的文件时出现的问题。

功能与升级

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 属性在数据稀疏的工作表中错误地返回 null 的问题。
• 修复了在向不同工作表中添加表格时 CreateNamedTable 导致 Excel 文件损坏的问题。

功能与升级

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

发布说明：

更新

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

错误修复

• 修复了当使用包含超过 500 行的 Excel 文件时，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 类，用于表示单元格注释，并为所有注释属性提供 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 的功能。
• 添加对数据验证的支持：
  • 向 DataValidations 属性添加了 WorkSheet。 它包含工作表中的所有数据验证，并包含添加和删除数据验证的方法。
  • 所有数据验证类型均可从电子表格中读取。
  • 可以将 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 方法组添加到 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 属性，以返回范围内的列/行数，而无需遍历所有单元格。
• 改进 Range 类及其继承者的文档。
• InsertRow 和 InsertColumn 方法现在将返回插入的行/列。 InsertRows 和 InsertColumns 方法也是如此，但这些方法将返回插入的列/行的列表。
• 当范围发生变化时，范围的地址将得到正确更新（使用 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 描述
• 修复了当工作表中不存在任何列时访问 WorkSheet.PhysicalColumnCount 属性会引发异常的错误
• 改进了 Cell.Hyperlink 属性的 IntelliSense 描述
• 修复了在某些情况下设置 Cell.Hyperlink 属性时会检测到错误超链接类型的错误。
• 改进了当系统中未找到字体时使用 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 抛出异常。
• 修复了一个错误，即对 RangeFont 和 RangeBorder 的属性调用 getter 时，会不必要地创建范围内的所有单元格。
• 修正了一个错误，即在加载具有特定 WebPublishing 设置的 .XLSX 文件时会出现异常。
• 添加 WorkSheet.PhysicalColumnCount 和 WorkSheet.PhysicalRowCount 属性，返回当前工作表中实际存在的行数和列数。
• 改进和更新 IntelliSense 文档，以澄清 WorkSheet 和 Range 的一些属性和方法。
• 提高读取 Range 对象的任何属性时的性能，尤其是在处理大范围属性时。 这适用于从 Range 继承的所有对象（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 时，某些边框样式会导致异常。
• 修复了 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.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.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 对象的替代品。
• 修正了一个 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 兼容
• 已修复错误：从项目配置文件中读取许可证密钥（特殊情况）
• 提升：速度和稳定性