由于存在BinaryFormatter,以下 API 在 .NET 5 中标记为已过时。 在代码中使用它们会在编译时生成警告或错误 SYSLIB0011 。
- System.Exception.SerializeObjectState
- BinaryFormatter.Serialize
- BinaryFormatter.Deserialize
- Formatter.Serialize(Stream, Object)
- Formatter.Deserialize(Stream)
- IFormatter.Serialize(Stream, Object)
- IFormatter.Deserialize(Stream)
从 .NET 8 开始,BinaryFormatter.Serialize 和 BinaryFormatter.Deserialize 在大多数项目类型中会在运行时抛出NotSupportedException。 此外, PreserializedResourceWriter.AddBinaryFormattedResource(String, Byte[], String) 已过时 为警告,以下 API 已过时 为错误:
- System.Runtime.Serialization.Formatter
- System.Runtime.Serialization.IFormatter
- System.Runtime.Serialization.Formatters.Binary.BinaryFormatter
解决方法
如果使用 BinaryFormatter,应因为其安全性和可靠性方面的缺陷而迁移到其他选项。 有关详细信息,请参阅使用 BinaryFormatter 和相关类型时的反序列化风险和首选替代项。
禁止显示警告
如果必须使用过时的 API,可以在代码或项目文件中禁止显示警告/错误。
若要仅取消单个冲突,请将预处理器指令添加到源文件以禁用,然后重新启用警告。
// Disable the warning.
#pragma warning disable SYSLIB0011
// Code that uses obsolete API.
// ...
// Re-enable the warning.
#pragma warning restore SYSLIB0011
若要取消项目中的所有 SYSLIB0011 警告,请将属性 <NoWarn> 添加到项目文件。
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
...
<NoWarn>$(NoWarn);SYSLIB0011</NoWarn>
</PropertyGroup>
</Project>
有关详细信息,请参阅 禁止显示警告。