.NET 7 核心库变更：SerializationFormat.Binary 已过时

.NET 7 核心库变更：SerializationFormat.Binary 已过时

docs This repository contains .NET Documentation. 项目地址: https://gitcode.com/gh_mirrors/docs2/docs

背景介绍

在 .NET 生态系统中，数据序列化是一个基础且重要的功能。DataSet 和 DataTable 作为 .NET 中处理关系型数据的核心类，长期以来支持两种序列化格式：XML 和二进制。然而，随着 .NET 7 的发布，二进制序列化方式被标记为过时(obsolete)。

变更内容

过时警告与异常行为

在 .NET 7 中，System.Data.SerializationFormat.Binary 枚举值被标记为过时。这意味着：

1. 编译时：使用该枚举值的代码会产生 SYSLIB0038 警告
2. 运行时：以下操作会抛出 InvalidEnumArgumentException 异常
   • 将 DataSet.RemotingFormat 或 DataTable.RemotingFormat 属性设置为 SerializationFormat.Binary
   • 使用二进制数据调用 DataTable 或 DataSet 的反序列化构造函数

受影响版本

此变更从 .NET 7 开始生效。

变更原因

这项变更的根本原因是二进制序列化依赖于 BinaryFormatter，而该格式化器存在以下问题：

1. 安全问题：BinaryFormatter 在某些情况下可能带来风险
2. 不可靠性：二进制序列化对类型版本变化非常敏感
3. 跨平台问题：二进制格式在不同平台间可能存在兼容性问题

微软正在逐步调整整个 .NET 栈中的 BinaryFormatter 使用，这是整体策略的一部分。

兼容性影响

此变更会影响：

• 源代码兼容性：需要修改现有代码
• 二进制兼容性：依赖二进制序列化的程序集需要重新编译

迁移建议

推荐方案

1. 改用 XML 序列化：

   dataSet.RemotingFormat = SerializationFormat.Xml;
   

2. 使用其他序列化技术：

   • JSON 序列化 (如 System.Text.Json)
   • 协议缓冲区 (如 Google.Protobuf)

临时解决方案

如果短期内无法迁移，可以通过设置 AppContext 开关临时恢复旧行为：

AppContext.SetSwitch("Switch.System.Data.AllowUnsafeSerializationFormatBinary", true);

但需要注意：

• 这只是临时解决方案
• 该开关将在 .NET 8 中移除
• 仍然存在潜在问题

受影响 API 列表

• System.Data.SerializationFormat.Binary
• DataSet.RemotingFormat 属性
• DataTable.RemotingFormat 属性
• DataSet 的二进制反序列化构造函数
• DataTable 的二进制反序列化构造函数

最佳实践

1. 尽早迁移：不要等到 .NET 8 移除开关时才行动
2. 安全评估：检查现有二进制数据是否来自可信源
3. 测试验证：迁移后确保数据完整性和功能正确性
4. 文档更新：更新相关文档说明序列化方式变更

总结

这项变更是 .NET 发展的重要一步。虽然短期内可能需要一些迁移工作，但从长远来看，转向更现代、更可靠的序列化方式将提高应用程序的可维护性。开发人员应当优先考虑使用 XML 或其他更合适的序列化方案来替代二进制序列化。

docs This repository contains .NET Documentation. 项目地址: https://gitcode.com/gh_mirrors/docs2/docs