Udostępnij za pośrednictwem

CA1824: Oznacz zestawy za pomocą NeutralResourcesLanguageAttribute

Właściwości Wartość
Identyfikator reguły CA1824
Tytuł Oznaczaj zestawy za pomocą atrybutu NeutralResourcesLanguageAttribute
Kategoria Wydajność
Poprawka łamiąca lub nienaruszająca Niezgodność
Domyślnie włączone na platformie .NET 10 Jako sugestia
Zastosowane języki C# i Visual Basic

Przyczyna

Zestaw zawiera zasób bazujący na ResX, ale nie zastosowano do niego System.Resources.NeutralResourcesLanguageAttribute.

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 standardowe sondowanie modułów, zwiększa wydajność wyszukiwania dla pierwszego załadowanego zasobu i może zmniejszyć zestaw roboczy.

Wskazówka

Zobacz Tworzenie pakietów i wdrażanie zasobów, aby zapoznać się z procesem, który ResourceManager używa do przeszukiwania 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 lub Assembly neutral language.

  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ż

  • Last updated on