Sdílet prostřednictvím


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.