CA1824: Označte sestavení pomocí atributu NeutralResourcesLanguageAttribute

Vlastnost Hodnota
ID pravidla CA1824
Název Označte sestavení pomocí NeutralResourcesLanguageAttribute
Kategorie Výkon
Oprava, která může být destruktivní nebo nedestruktivní Nezlomitelný
Povoleno ve výchozím nastavení v .NET 10 Jako návrh
Příslušné jazyky C# a Visual Basic

Příčina

Sestavení obsahuje prostředek založený na ResX, ale nemá na něj aplikovaný System.Resources.NeutralResourcesLanguageAttribute.

Popis pravidla

Atribut NeutralResourcesLanguageAttribute informuje správce prostředků o výchozí kultuře 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í standardní ověřování sestavení, což zlepšuje výkon při vyhledávání prvního načteného prostředku a může snížit velikost pracovní sady.

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í kultury.

Určení neutrálního jazyka pro prostředky

  1. V Průzkumník řešení klikněte pravým tlačítkem myši na projekt a pak vyberte Vlastnosti.

  2. Vyberte kartu Balíček.

    Poznámka:

    Pokud je váš projekt projekt .NET Framework, vyberte kartu Aplikace, a poté vyberte Informace o sestavení.

  3. V rozbalovacím seznamu Neutrální jazyk nebo Neutrální jazyk sestavení vyberte jazyk.

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

Viz také