SYSLIB0045：某些密碼編譯 Factory 方法已淘汰

下列 System.Security.Cryptography 方法從 .NET 7 開始已淘汰。 在程式碼中使用這些 API 會導致在編譯時期產生警告 SYSLIB0045。 這些 Factory 方法都會接受代表演算法名稱的字串引數。 這些方法會呼叫 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] 的型別相關聯。

因應措施

傳遞常數字串的呼叫應該變更為無參數的 Factory 方法或強式呼叫，以建立適當的型別。 例如，呼叫 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>

如需詳細資訊，請參閱隱藏警告。