CA1824: Oznacz zestawy za pomocą NeutralResourcesLanguageAttribute

  • Artykuł
Właściwości Wartość
Identyfikator reguły CA1824
Tytuł Oznaczaj zestawy za pomocą atrybutu NeutralResourcesLanguageAttribute
Kategoria Wydajność
Poprawka powodująca niezgodność lub niezgodność Niezgodność
Domyślnie włączone na platformie .NET 8 Jako sugestia

Przyczyna

Zestaw zawiera zasób oparty na protokole ResX, ale nie ma do niego zastosowanego System.Resources.NeutralResourcesLanguageAttribute zasobu.

Opis reguły

Atrybut NeutralResourcesLanguageAttribute informuje menedżera zasobów o domyślnej kulturze aplikacji. Jeśli zasoby kultury domyślnej są osadzone w głównym zestawie aplikacji i ResourceManager muszą pobierać zasoby należące do tej samej kultury co kultura domyślna, ResourceManager automatycznie używa zasobów znajdujących się w zestawie głównym zamiast wyszukiwania zestawu satelitarnego. To pomija zwykłą sondę zestawu, poprawia wydajność wyszukiwania dla pierwszego załadowanych zasobów i może zmniejszyć zestaw roboczy.

Napiwek

Zobacz Tworzenie pakietów i wdrażanie zasobów dla procesu używanego ResourceManager do sondowania plików zasobów.

Naprawianie naruszeń

Aby naprawić naruszenie tej reguły, dodaj atrybut do zestawu i określ język zasobów kultury neutralnej.

Aby określić neutralny język dla zasobów

  1. W Eksplorator rozwiązań kliknij prawym przyciskiem myszy projekt, a następnie wybierz polecenie Właściwości.

  2. Wybierz kartę Pakiet .

    Uwaga

    Jeśli projekt jest projektem .NET Framework, wybierz kartę Aplikacja , a następnie wybierz pozycję Informacje o zestawie.

  3. Wybierz język z listy rozwijanej Neutral language (Język neutralny) lub Assembly neutral language (Język neutralny dla zestawu ).

  4. Wybierz przycisk OK.

Kiedy pomijać ostrzeżenia

Można pominąć ostrzeżenie z tej reguły. Jednak wydajność uruchamiania może ulec pogorszeniu. Aby pominąć to ostrzeżenie, dodaj dotnet_diagnostic.CA1824.severity = none plik .globalconfig lub .editorconfig .

Pomijanie ostrzeżenia

Jeśli chcesz po prostu pominąć pojedyncze naruszenie, dodaj dyrektywy preprocesora do pliku źródłowego, aby wyłączyć, a następnie ponownie włączyć regułę.

#pragma warning disable CA1824
// The code that's violating the rule is on this line.
#pragma warning restore CA1824

Aby wyłączyć regułę dla pliku, folderu lub projektu, ustaw jego ważność na none w pliku konfiguracji.

[*.{cs,vb}]
dotnet_diagnostic.CA1824.severity = none

Aby uzyskać więcej informacji, zobacz Jak pominąć ostrzeżenia dotyczące analizy kodu.

Zobacz też