CA1824: Assembly's markeren met NeutralResourcesLanguageAttribute
| Eigenschappen | Weergegeven als |
|---|---|
| Regel-id | CA1824 |
| Titel | Assembly's markeren met NeutralResourcesLanguageAttribute |
| Categorie | Prestaties |
| Oplossing is brekend of niet-brekend | Niet-brekend |
| Standaard ingeschakeld in .NET 9 | Als suggestie |
Oorzaak
Een assembly bevat een Resource op basis van ResX, maar heeft er niet op System.Resources.NeutralResourcesLanguageAttribute toegepast.
Beschrijving van regel
Het NeutralResourcesLanguageAttribute kenmerk informeert de resourcemanager over de standaardcultuur van een app. Als de resources van de standaardcultuur zijn ingesloten in de hoofdassembly van de app en ResourceManager resources moet ophalen die deel uitmaken van dezelfde cultuur als de standaardcultuur, worden de ResourceManager resources die zich in de hoofdassembly bevinden, automatisch gebruikt in plaats van te zoeken naar een satellietassembly. Hierdoor wordt de gebruikelijke assemblytest overgeslagen, worden de opzoekprestaties voor de eerste resource die u laadt, verbeterd en kunt u de werkset verminderen.
Tip
Zie Resources verpakken en implementeren voor het proces dat ResourceManager wordt gebruikt om resourcebestanden te testen.
Schendingen oplossen
Als u een schending van deze regel wilt oplossen, voegt u het kenmerk toe aan de assembly en geeft u de taal op van de resources van de neutrale cultuur.
De neutrale taal voor resources opgeven
Klik in Solution Explorer met de rechtermuisknop op uw project en selecteer Vervolgens Eigenschappen.
Selecteer het tabblad Pakket .
Notitie
Als uw project een .NET Framework-project is, selecteert u het tabblad Toepassing en selecteert u assemblygegevens.
Selecteer de taal in de vervolgkeuzelijst Neutrale taal of Assembly neutrale taal .
Selecteer OK.
Wanneer waarschuwingen onderdrukken
Het is toegestaan om een waarschuwing van deze regel te onderdrukken. Opstartprestaties kunnen echter afnemen. Als u deze waarschuwing wilt onderdrukken, voegt u dit toe aan uw .globalconfig- of .editorconfig-bestand.dotnet_diagnostic.CA1824.severity = none
Een waarschuwing onderdrukken
Als u slechts één schending wilt onderdrukken, voegt u preprocessorrichtlijnen toe aan uw bronbestand om de regel uit te schakelen en vervolgens opnieuw in te schakelen.
#pragma warning disable CA1824
// The code that's violating the rule is on this line.
#pragma warning restore CA1824
Als u de regel voor een bestand, map of project wilt uitschakelen, stelt u de ernst none ervan in op het configuratiebestand.
[*.{cs,vb}]
dotnet_diagnostic.CA1824.severity = none
Zie Codeanalysewaarschuwingen onderdrukken voor meer informatie.
