CA2255：屬性 ModuleInitializer 不應該用於連結庫
| 屬性 | 值 |
|---|---|
| 規則識別碼 | CA2255 |
| 職稱 | ModuleInitializer 屬性不應該用於程式庫中 |
| 類別 | 使用方式 |
| 修正程式是中斷或非中斷 | 不中斷 |
| 預設在 .NET 9 中啟用 | 作為警告 |
原因
套 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
如需詳細資訊，請參閱 如何隱藏程式代碼分析警告。
