CA2255: ModuleInitializer 属性をライブラリ内で使用しないでください
| プロパティ | 値 |
|---|---|
| ルール ID | CA2255 |
| Title | 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
詳細については、「コード分析の警告を抑制する方法」を参照してください。
こちらもご覧ください
.NET