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 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
W Eksplorator rozwiązań kliknij prawym przyciskiem myszy projekt, a następnie wybierz polecenie Właściwości.
Wybierz kartę Pakiet .
Uwaga
Jeśli projekt jest projektem .NET Framework, wybierz kartę Aplikacja , a następnie wybierz pozycję Informacje o zestawie.
Wybierz język z listy rozwijanej Neutral language (Język neutralny) lub Assembly neutral language (Język neutralny dla zestawu ).
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.