SYSLIB0045:某些加密工厂方法已过时
从 .NET 7 开始,以下 System.Security.Cryptography
方法已过时。 在代码中使用这些 API 会在编译时生成警告 SYSLIB0045
。 其中的每个工厂方法都接受表示算法名的字符串参数。 这些方法调用 CryptoConfig.CreateFromName 并将结果强制转换为返回类型。
- Aes.Create(String)
- AsymmetricAlgorithm.Create(String)
- DES.Create(String)
- ECDiffieHellman.Create(String)
- ECDsa.Create(String)
- HashAlgorithm.Create(String)
- KeyedHashAlgorithm.Create(String)
- RandomNumberGenerator.Create(String)
- RC2.Create(String)
- Rijndael.Create(String)
- RSA.Create(String)
- SHA1.Create(String)
- SHA256.Create(String)
- SHA384.Create(String)
- SHA512.Create(String)
- SymmetricAlgorithm.Create(String)
- TripleDES.Create(String)
这些方法被标记为 [Obsolete]
,因为在剪裁应用程序中,它们可以返回 null
,而在非剪裁应用程序中不能。 此外,在非剪裁应用程序中,这些方法的基于异常的行为偶尔会让调用方感到惊讶,而且许多已知标识符与本身标记为 [Obsolete]
的类型相关联。
解决方法
传递常量字符串的调用应更改为无参数工厂方法或强调用以创建适当的类型。 例如,Aes.Create("AES")
调用可替换为 Aes.Create()
或 new AesCryptoServiceProvider()
。 由于 AesCryptoServiceProvider 类型也标记为 [Obsolete]
,因此 Aes.Create()
是首选替换类型。
传递非常量字符串的调用可以使用自己的查找表,也可以更改为直接调用 CryptoConfig.CreateFromName。
抑制警告
如果必须使用已过时的 API,可在代码或项目文件中禁止显示警告。
若只想抑制单个冲突,请将预处理器指令添加到源文件以禁用该规则,然后重新启用警告。
// Disable the warning.
#pragma warning disable SYSLIB0045
// Code that uses obsolete API.
// ...
// Re-enable the warning.
#pragma warning restore SYSLIB0045
若要禁止显示项目中的所有 SYSLIB0045
警告,请将属性 <NoWarn>
添加到项目文件。
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
...
<NoWarn>$(NoWarn);SYSLIB0045</NoWarn>
</PropertyGroup>
</Project>
有关详细信息,请参阅取消警告。