CA2255：屬性 ModuleInitializer 不應該用於程式庫

屬性	值
規則識別碼	CA2255
標題	不應該在連結 ModuleInitializer 庫中使用屬性
類別	使用方式
修正程式是中斷或非中斷	不中斷
預設在 .NET 8 中啟用	作為警告

原因

套 ModuleInitializerAttribute 用至類別庫內的方法。

檔案描述

模組初始設定式旨在供應用程式程式碼使用，以確保應用程式元件會在應用程式程式碼開始執行之前初始化。 如果程式庫程式碼使用 ModuleInitializerAttribute 宣告方法，它可能會干擾應用程式初始化，也會導致該應用程式修剪能力的限制。 因此，程式庫程式碼不應使用 ModuleInitializerAttribute 屬性。

如何修正違規

程式庫不應該使用標示 ModuleInitializerAttribute 的方法，而是公開可用來初始化程式庫內任何元件的方法，並允許應用程式在應用程式初始化期間叫用 方法。

隱藏警告的時機

如果解決方案使用類別庫進行程式碼分解，而且 ModuleInitializerAttribute 方法不是共用或分散式程式庫或套件的一部分，則隱藏此規則的警告是安全的。

隱藏警告

如果您只想要隱藏單一違規，請將預處理器指示詞新增至原始程式檔以停用，然後重新啟用規則。

#pragma warning disable CA2255
// The code that's violating the rule is on this line.
#pragma warning restore CA2255

若要停用檔案、資料夾或專案的規則，請在組態檔 中將其嚴重性設定為 。 none

[*.{cs,vb}]
dotnet_diagnostic.CA2255.severity = none

若要停用此整個規則類別，請將組態檔中類別的嚴重性設定為 none 。

[*.{cs,vb}]
dotnet_analyzer_diagnostic.category-Usage.severity = none

如需詳細資訊，請參閱 如何隱藏程式碼分析警告 。

另請參閱

• 使用警告