Iron Suite for .NET
10个.NET库。一整套文档。
迁移到.NET 11?请先检查这些破坏性更改
.NET 11即将发布,重大更改列表已经上线。我们逐行检查了它,以便您在升级时知道需要注意什么。
这是个好消息,但这也使迁移测试变得更加重要。
许多应用程序在重新定位到.NET 11后仍能干净地编译。更大的风险在于行为变化:代码成功构建但抛出新异常、以不同方式处理数据或在运行时产生略有不同的结果。
本指南不逐一介绍每个兼容性项目,而是专注于最有可能影响实际应用程序的更改,以及在投入生产之前应该测试的内容。
一览表
| 更改 | 发生了什么 |
|---|---|
| ZIP读取验证CRC32 | 在损坏的条目上抛出InvalidDataException |
DateOnly/TimeOnly TryParse | 在无效格式或样式上抛出 |
BackgroundService失败 | 主机在启动/关闭时抛出 |
| Math.Round正确性 | 返回正确舍入的结果 |
| 共享框架中的扩展 | 程序集版本解析可能会改变 |
| 构建和测试工具 | VSTest、NuGet、模板引擎更改 |
我们首先检查的:ZIP读取现在抛出
这是最有可能让文档密集型代码库感到意外的更改,因为它在出问题之前是无声的。从.NET 11开始,System.IO.Compression在读取ZIP条目时验证CRC32校验和,如果存储的校验和与数据不匹配,则抛出InvalidDataException。以前,损坏或被篡改的条目会直接读取而没有任何抱怨。
这是一个真正好的变化,您希望知道文件是否有问题,但如果您的应用程序从用户、合作伙伴或旧存储桶中获取ZIP文件,多年来“工作正常”的代码可能会开始抛出。修复很简单:将读取操作包装在一个try-catch中以捕获InvalidDataException,并决定如何处理损坏的存档。最好有意捕获它,而不是在生产中发现它。
隐蔽的:TryParse现在可能抛出
每个.NET开发人员都已经内化了TryParse从不抛出,它返回一个布尔值。在.NET 11中,DateOnly.TryParse、TimeOnly.TryParse及其TryParseExact兄弟稍微打破了这一习惯:传递一个无效的DateTimeStyles值或错误的格式说明符,它们现在抛出ArgumentException而不是安静地返回false。如果您的格式字符串和样式是硬编码且有效的,则不会有任何变化。如果它们是在运行时计算的或来自用户输入,那就是一个新的异常路径需要覆盖。
仅在相关时检查
其余的更窄,并按其所在位置分组:
- ASP.NET Core。 多年前标记为过时的旧Blazor API不再编译。Kestrel对格式错误的HTTP头更加严格。如果您的SQL连接字符串使用Entra ID (
Active Directory)身份验证,现在需要Microsoft.Data.SqlClient.Extensions.Azure包,这也会影响EF Core SQL Server用户。 - 扩展和托管。 工作服务失败得更明显:如果
BackgroundService抛出,主机也会抛出,因此请测试您的启动路径。 - 核心库。
Math.Round和复数变得更加符合标准,这仅在测试期望旧值时才重要。 - 构建和工具。 VSTest放弃了Newtonsoft.Json,模板包放弃了netstandard2.0。这些会以构建错误的形式出现,因此它们会自我宣布。
- 平台。 最低CPU要求提高,.NET MAUI需要Android API 24,默认情况下关闭TLS服务器端证书获取。如果这些与您相关,您会知道的。
您无需担心的一件事
当您审核.NET 11 的依赖项准备情况时,您的文档工具不应该在列表中。Iron Suite 库是纯托管的.NET,已经可以在.NET 11 到.NET Framework 上运行,因此 IronPDF、IronXL 和套件中的其他库会随着您的应用程序一起移动,而不是阻碍它。值得注意的是,上述 ZIP 更改与这些库替换的文件处理代码类型紧密相邻,如果您有手动编写的文档或归档管道,迁移是将该部分交给已经跟踪每个.NET 版本的库的自然时机。
完整列表,包括独立页面上的 ASP.NET Core 更改,Microsoft .NET 11 重大更改参考 是值得收藏的来源。随着列表的增长,我们将更新这篇文章,因为它仍在不断完善中。