Udostępnij za pośrednictwem

CA1714: Typy wyliczeniowe flag powinny mieć nazwy w liczbie mnogiej

Właściwości Wartość
Identyfikator reguły CA1714
Tytuł Wyliczenia z atrybutem Flags powinny mieć nazwy w liczbie mnogiej
Kategoria Nazewnictwo
Poprawka łamiąca lub nienaruszająca Przełomowe
Domyślnie włączone na platformie .NET 10 Nie.
Zastosowane języki C# i Visual Basic

Przyczyna

Wyliczenie ma System.FlagsAttribute i jego nazwa nie kończy się na 's'.

Domyślnie ta reguła analizuje tylko widoczne zewnętrznie wyliczenia, ale można to skonfigurować.

Opis reguły

Typy oznaczone nazwami FlagsAttribute mają liczbę mnogą, ponieważ atrybut wskazuje, że można określić więcej niż jedną wartość. Na przykład wyliczenie, które definiuje dni tygodnia, może być przeznaczone do użycia w aplikacji, w której można określić wiele dni. To wyliczenie powinno mieć wartość FlagsAttribute i może mieć nazwę "Days". Podobne wyliczenie, które umożliwia określenie tylko jednego dnia, nie będzie miało atrybutu i może być nazywane "Dzień".

Konwencje nazewnictwa zapewniają spójny format dla bibliotek działających w środowisku uruchomieniowym języka wspólnego. Zmniejsza to krzywą uczenia wymaganą dla nowych bibliotek oprogramowania i zwiększa pewność klienta, że biblioteka została opracowana przez kogoś, kto ma doświadczenie w tworzeniu kodu zarządzanego.

Jak naprawić naruszenia

Zmień nazwę wyliczenia na liczbę mnogą lub usuń atrybut FlagsAttribute, jeśli nie należy jednocześnie określać wielu wartości wyliczenia.

Kiedy pomijać ostrzeżenia

Można bezpiecznie pominąć błąd, jeśli słowo jest w liczbie mnogiej, ale nie kończy się na "s". Na przykład, gdyby wyliczenie obejmujące wiele dni, które zostało opisane wcześniej, nosiło nazwę "DaysOfTheWeek", naruszałoby to logikę reguły, ale nie jej intencję. Takie naruszenia powinny zostać stłumione.

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 CA1714
// The code that's violating the rule is on this line.
#pragma warning restore CA1714

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

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

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

Konfigurowanie kodu do analizowania

Użyj następującej opcji, aby skonfigurować, które części kodu mają być objęte tą regułą.

Tę opcję można skonfigurować tylko dla tej reguły, dla wszystkich reguł, do których ma ona zastosowanie, lub dla wszystkich reguł w tej kategorii (nazewnictwo), których dotyczy. Aby uzyskać więcej informacji, zobacz Opcje konfiguracji reguły jakości kodu.

Uwzględnij określone powierzchnie interfejsu API

Możesz skonfigurować, na które części bazy kodu ma być stosowana ta reguła, na podstawie ich poziomu dostępu, ustawiając opcję api_surface. Aby na przykład określić, że reguła powinna być uruchamiana tylko na powierzchni niepublicznego interfejsu API, dodaj następującą parę klucz-wartość do pliku editorconfig w projekcie:

dotnet_code_quality.CAXXXX.api_surface = private, internal

Notatka

Zastąp część XXXXCAXXXX identyfikatorem odpowiedniej reguły.

Zobacz też

  • Last updated on