CA1824:アセンブリを NeutralResourcesLanguageAttribute に設定します
| プロパティ | 値 |
|---|---|
| ルール ID | CA1824 |
| Title | アセンブリを NeutralResourcesLanguageAttribute に設定します |
| [カテゴリ] | パフォーマンス |
| 修正が中断ありか中断なしか | なし |
| .NET 9 では既定で有効 | 提案として |
原因
アセンブリに、ResXベースのリソースが含まれていますが、System.Resources.NeutralResourcesLanguageAttribute が適用されていません。
規則の説明
NeutralResourcesLanguageAttribute 属性では、アプリケーションの既定のカルチャをリソース マネージャーに通知します。 既定のカルチャのリソースがアプリケーションのメイン アセンブリに埋め込まれ、ResourceManager が既定のカルチャと同じカルチャに属するリソースを取得する必要がある場合、ResourceManager では、サテライト アセンブリを検索するのではなく、メイン アセンブリにあるリソースを自動的に使用します。 これにより、通常のアセンブリ プローブがバイパスされ、読み込んだ最初のリソースに対する検索パフォーマンスが向上し、ワーキング セットを縮小できます。
ヒント
リソース ファイルをプローブするために ResourceManager が使用する手順については、リソースをパッケージ化して配置するに関するページを参照してください。
違反の修正
この規則の違反を修正するには、属性をアセンブリに追加し、ニュートラル カルチャのリソースの言語を指定します。
リソースに対してニュートラル言語を指定するには
ソリューション エクスプローラーで、プロジェクトを右クリックしてから [プロパティ] を選択します。
[パッケージ] タブを選択します。
注意
プロジェクトが .NET Framework プロジェクトの場合は、 [アプリケーション] タブを選択してから、 [アセンブリ情報] を選択します。
[ニュートラル言語] または [アセンブリ ニュートラル言語] ドロップダウン リストから言語を選択します。
[OK] を選択します。
どのようなときに警告を抑制するか
この規則の警告を抑制できます。 ただし、起動時のパフォーマンスが低下する可能性があります。 この警告を抑制するには、dotnet_diagnostic.CA1824.severity = none を .globalconfig または .editorconfig ファイルに追加します。
警告を抑制する
単一の違反を抑制するだけの場合は、ソース ファイルにプリプロセッサ ディレクティブを追加して無効にしてから、規則をもう一度有効にします。
#pragma warning disable CA1824
// The code that's violating the rule is on this line.
#pragma warning restore CA1824
ファイル、フォルダー、またはプロジェクトの規則を無効にするには、構成ファイルでその重要度を none に設定します。
[*.{cs,vb}]
dotnet_diagnostic.CA1824.severity = none
詳細については、「コード分析の警告を抑制する方法」を参照してください。
関連項目
.NET