CA2255：屬性
| 屬性 | 值 |
|---|---|
| 規則識別碼 | CA2255 |
| 職稱 |
ModuleInitializer 屬性不應該用於程式庫中 |
| 類別 | 使用方式 |
| 修正是造成中斷還是不中斷 | 不中斷 |
| 在 .NET 10 中預設啟用 | 作為警告 |
| 適用語言 | C# 與 Visual Basic |
原因
將 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
如需詳細資訊，請參閱 如何隱藏程式代碼分析警告。
