CA1824: Mark assemblies with NeutralResourcesLanguageAttribute
Note
This article applies to Visual Studio 2015. If you're looking for the latest Visual Studio documentation, see Visual Studio documentation. We recommend upgrading to the latest version of Visual Studio. Download it here
| Item | Value |
|---|---|
| TypeName | MarkAssembliesWithNeutralResourcesLanguage |
| CheckId | CA1824 |
| Category | Microsoft.Performance |
| Breaking Change | Non-breaking |
Cause
An assembly contains a ResX-based resource but does not have the System.Resources.NeutralResourcesLanguageAttribute applied to it.
Rule Description
The NeutralResourcesLanguage attribute informs the ResourceManager of the language that was used to display the resources of the neutral culture for an assembly. When it looks up resources in the same culture as the neutral resources language, the ResourceManager automatically uses the resources that are located in the main assembly. It does this instead of searching for a satellite assembly that has the current user interface culture for the current thread. This improves lookup performance for the first resource that you load and can reduce your working set.
Fixing Violations
To fix a violation of this rule, add the attribute to the assembly, and specify the language of the resources of the neutral culture.
Specifying the Language
To specify the language of the resource of the neutral culture
In Solution Explorer, right-click your project, and then Click Properties.
From the left navigation bar select Application, and then click Assembly Information.
In the Assembly Information dialog box, select the language from the Neutral Language drop-down list.
Click OK.
When to Suppress Warnings
It is permissible to suppress a warning from this rule. However, startup performance might decrease.