CA1824: Označte sestavení pomocí atributu NeutralResourcesLanguageAttribute
Vlastnost | Hodnota |
---|---|
ID pravidla | CA1824 |
Název | Označte sestavení pomocí NeutralResourcesLanguageAttribute |
Kategorie | Výkon |
Oprava způsobující chybu nebo chybu způsobující chybu | Nenarušující |
Povoleno ve výchozím nastavení v .NET 9 | Jako návrh |
Příčina
Sestavení obsahuje prostředek založený na resX, ale nemá System.Resources.NeutralResourcesLanguageAttribute na něj použitý prostředek.
Popis pravidla
Atribut NeutralResourcesLanguageAttribute informuje správce prostředků o výchozí jazykové verzi aplikace. Pokud jsou prostředky výchozí jazykové verze vložené do hlavního sestavení aplikace a ResourceManager musí načíst prostředky, které patří do stejné jazykové verze jako výchozí jazyková verze, ResourceManager automaticky použije prostředky umístěné v hlavním sestavení místo hledání satelitního sestavení. Tím se obchází obvyklá sonda sestavení, zlepšuje výkon vyhledávání prvního prostředku, který načítáte, a může snížit pracovní sadu.
Tip
Viz Balíček a nasazení prostředků pro proces, který ResourceManager používá k sondování souborů prostředků.
Oprava porušení
Chcete-li opravit porušení tohoto pravidla, přidejte atribut do sestavení a zadejte jazyk prostředků neutrální jazykové verze.
Určení neutrálního jazyka pro prostředky
V Průzkumník řešení klikněte pravým tlačítkem myši na projekt a pak vyberte Vlastnosti.
Vyberte kartu Balíček.
Poznámka:
Pokud je projektem rozhraní .NET Framework, vyberte kartu Aplikace a pak vyberte Informace o sestavení.
V rozevíracím seznamu Neutrální jazyk nebo Jazyk neutrální sestavení vyberte jazyk .
Vyberte OK.
Kdy potlačit upozornění
Je možné potlačit upozornění z tohoto pravidla. Výkon spouštění se ale může snížit. Chcete-li toto upozornění potlačit, přidejte dotnet_diagnostic.CA1824.severity = none
do souboru .globalconfig nebo .editorconfig .
Potlačení upozornění
Pokud chcete pouze potlačit jedno porušení, přidejte do zdrojového souboru direktivy preprocesoru, abyste pravidlo zakázali a znovu povolili.
#pragma warning disable CA1824
// The code that's violating the rule is on this line.
#pragma warning restore CA1824
Pokud chcete pravidlo pro soubor, složku nebo projekt zakázat, nastavte jeho závažnost v none
konfiguračním souboru.
[*.{cs,vb}]
dotnet_diagnostic.CA1824.severity = none
Další informace naleznete v tématu Jak potlačit upozornění analýzy kódu.