CA1824:アセンブリを NeutralResourcesLanguageAttribute に設定します

  • [アーティクル]
プロパティ 値
ルール ID CA1824
Title アセンブリを NeutralResourcesLanguageAttribute に設定します
[カテゴリ] パフォーマンス
修正が中断ありか中断なしか なし
.NET 8 では既定で有効 提案として

原因

アセンブリに、ResXベースのリソースが含まれていますが、System.Resources.NeutralResourcesLanguageAttribute が適用されていません。

規則の説明

NeutralResourcesLanguageAttribute 属性では、アプリケーションの既定のカルチャをリソース マネージャーに通知します。 既定のカルチャのリソースがアプリケーションのメイン アセンブリに埋め込まれ、ResourceManager が既定のカルチャと同じカルチャに属するリソースを取得する必要がある場合、ResourceManager では、サテライト アセンブリを検索するのではなく、メイン アセンブリにあるリソースを自動的に使用します。 これにより、通常のアセンブリ プローブがバイパスされ、読み込んだ最初のリソースに対する検索パフォーマンスが向上し、ワーキング セットを縮小できます。

ヒント

リソース ファイルをプローブするために ResourceManager が使用する手順については、リソースをパッケージ化して配置するに関するページを参照してください。

違反の修正

この規則の違反を修正するには、属性をアセンブリに追加し、ニュートラル カルチャのリソースの言語を指定します。

リソースに対してニュートラル言語を指定するには

  1. ソリューション エクスプローラーで、プロジェクトを右クリックしてから [プロパティ] を選択します。

  2. [パッケージ] タブを選択します。

    注意

    プロジェクトが .NET Framework プロジェクトの場合は、 [アプリケーション] タブを選択してから、 [アセンブリ情報] を選択します。

  3. [ニュートラル言語] または [アセンブリ ニュートラル言語] ドロップダウン リストから言語を選択します。

  4. [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

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

関連項目