Pravidla pojmenování
Pravidla vytváření názvů podporují dodržování zásad vytváření názvů pokynů pro návrh rozhraní .NET.
V této části
Pravidlo | Popis |
---|---|
CA1700: Nepojmenovávejte hodnoty výčtu "reserved" | Toto pravidlo předpokládá, že člen výčtu, který má název, který obsahuje "rezervované", se aktuálně nepoužívá, ale je zástupný symbol pro přejmenování nebo odebrání v budoucí verzi. Přejmenování nebo odebrání člena je zásadní změna. |
CA1707: Identifikátory by neměly obsahovat podtržítka | Podle konvence názvy identifikátorů neobsahují znak podtržítka (_). Toto pravidlo kontroluje obory názvů, typy, členy a parametry. |
CA1708: Identifikátory by se měly lišit více než pouze velikostí písmen | Identifikátory oborů názvů, typů, členů a parametrů se nemohou lišit pouze velikostí písmen, protože jazyky, které cílí na společné prostředí CLR (Common Language Runtime), nemusí rozlišovat malá a velká písmena. |
CA1710: Identifikátory by měly mít správnou příponu | Podle konvence mají názvy typů, které rozšiřují určité základní typy nebo implementují určitá rozhraní nebo typy odvozené z těchto typů, příponu přidruženou k základnímu typu nebo rozhraní. |
CA1711: Identifikátory by neměly mít nesprávnou příponu | Podle konvence by názvy typů, které rozšiřují určité základní typy, implementují určitá rozhraní, nebo jsou odvozené z těchto typů, měly končit konkrétními rezervovanými příponami. Jiné názvy typů by neměly používat tyto rezervované přípony. |
CA1712: Nepředcházejte hodnoty výčtu názvem typu | Názvy členů výčtu nemají předponu názvu typu, protože se očekává, že informace o typu budou poskytovány vývojářskými nástroji. |
CA1713: Události by neměly mít předponu či příponu | Název události začíná na "Before" nebo "After". Chcete-li pojmenovat související události, které jsou vyvolány v určité sekvenci, použijte aktuální nebo minulý čas k označení relativní pozice v posloupnosti akcí. |
CA1714: Výčty příznaků by měly mít názvy v množném čísle | Veřejný výčet má atribut System.FlagsAttribute a jeho název nekončí na "s". Typy označené příznakem FlagsAttribute mají názvy, které jsou množné číslo, protože atribut označuje, že lze zadat více než jednu hodnotu. |
CA1715: Identifikátory by měly mít správnou předponu | Název externě viditelného rozhraní nezačíná velkým písmenem "I". Název parametru obecného typu u externě viditelného typu nebo metody nezačíná velkým písmenem T. |
CA1716: Identifikátory by neměly odpovídat klíčovým slovům | Název jmenného prostoru nebo název typu odpovídá vyhrazenému klíčovému slovu v programovacím jazyce. Identifikátory pro obory názvů a typy by neměly odpovídat klíčovým slovům definovaným jazyky, které cílí na modul CLR (Common Language Runtime). |
CA1717: Pouze výčty FlagsAttribute by měly mít názvy v množném čísle | Konvence vytváření názvů určují, že název množného čísla výčtu indikuje, že ve stejnou dobu lze zadat více než jednu hodnotu výčtu. |
CA1720: Identifikátory by neměly obsahovat názvy typů | Název parametru v externě viditelném členu obsahuje název datového typu nebo název externě viditelného člena obsahuje název datového typu specifický pro jazyk. |
CA1721: Názvy vlastností by neměly odpovídat metodám get | Název veřejného nebo chráněného člena začíná na "Get" a jinak odpovídá názvu veřejné nebo chráněné vlastnosti. Metody a vlastnosti "Get" by měly mít názvy, které jasně rozlišují jejich funkci. |
CA1724: Názvy typů by neměly odpovídat názvům | Názvy typů by se neměly shodovat s názvy oborů názvů .NET. Porušení tohoto pravidla může snížit použitelnost knihovny. |
CA1725: Názvy parametrů by měly odpovídat základní deklaraci | Jednotné pojmenování parametrů v rámci přepisové hierarchie zvyšuje použitelnost metodických přepisů. Název parametru v odvozené metodě, která se liší od názvu v základní deklaraci, může způsobit nejasnosti o tom, zda je metoda přepsání základní metody nebo nové přetížení metody. |
CA1727: Pro pojmenované zástupné symboly použijte PascalCase | Pro pojmenované zástupné symboly použijte PascalCase v šabloně protokolovací zprávy. |
Spolupracujte s námi na GitHubu
Zdroj tohoto obsahu najdete na GitHubu, kde můžete také vytvářet a kontrolovat problémy a žádosti o přijetí změn. Další informace najdete v našem průvodci pro přispěvatele.