CA2255: ModuleInitializer 属性をライブラリ内で使用しないでください

プロパティ	値
ルール ID	CA2255
Title	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

詳細については、「コード分析の警告を抑制する方法」を参照してください。

こちらもご覧ください

• 使用法に関する警告