CA1714: Výčty příznaků by neměly mít názvy v množném čísle
| Vlastnost | Hodnota |
|---|---|
| ID pravidla | CA1714 |
| Název | Výčty příznaků by neměly mít názvy v množném čísle |
| Kategorie | Pojmenování |
| Oprava způsobující chybu nebo chybu způsobující chybu | Narušující |
| Povoleno ve výchozím nastavení v .NET 9 | No |
Příčina
Výčet má System.FlagsAttribute a jeho název nekončí na 's'.
Ve výchozím nastavení toto pravidlo sleduje jenom externě viditelné výčty, ale dá se konfigurovat.
Popis pravidla
Typy označené FlagsAttribute v množném čísle mají názvy, protože atribut označuje, že lze zadat více než jednu hodnotu. Například výčet, který definuje dny v týdnu, může být určen pro použití v aplikaci, kde můžete zadat více dní. Tento výčet by měl mít název FlagsAttribute Days (Dny). Podobný výčet, který umožňuje zadat pouze jeden den, by neměl atribut a lze ho volat "Den".
Konvence vytváření názvů poskytují společný vzhled knihoven, které cílí na modul CLR (Common Language Runtime). To snižuje křivku učení, která je nutná pro nové softwarové knihovny, a zvyšuje důvěru zákazníků, že knihovna byla vyvinuta někým, kdo má zkušenosti s vývojem spravovaného kódu.
Jak opravit porušení
Zadejte název výčtu slov v množném čísle nebo odeberte FlagsAttribute atribut, pokud by neměly být zadány více hodnot výčtu současně.
Kdy potlačit upozornění
Je bezpečné potlačit porušení, pokud je název množné číslo, ale nekončí na 's'. Pokud se například vícedenní výčet popsaný dříve jmenoval DaysOfTheWeek, porušuje logiku pravidla, ale ne její záměr. Taková porušení by měla být potlačena.
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 CA1714
// The code that's violating the rule is on this line.
#pragma warning restore CA1714
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.CA1714.severity = none
Další informace naleznete v tématu Jak potlačit upozornění analýzy kódu.
Konfigurace kódu pro analýzu
Pomocí následující možnosti nakonfigurujte, ve kterých částech základu kódu se má toto pravidlo spouštět.
Tuto možnost můžete nakonfigurovat jenom pro toto pravidlo, pro všechna pravidla, která platí, nebo pro všechna pravidla v této kategorii (pojmenování), na která platí. Další informace naleznete v tématu Možnosti konfigurace pravidla kvality kódu.
Zahrnutí konkrétních povrchů rozhraní API
Na základě přístupnosti můžete nakonfigurovat, na kterých částech základu kódu se má toto pravidlo spouštět. Pokud chcete například určit, že pravidlo by se mělo spouštět jenom na neveřejné ploše rozhraní API, přidejte do souboru .editorconfig v projektu následující pár klíč-hodnota:
dotnet_code_quality.CAXXXX.api_surface = private, internal
