CA1020: Vyvarujte se oborům názvu s malým množstvím typů

TypeName	AvoidNamespacesWithFewTypes
CheckId	CA1020
Kategorie	Microsoft.Design
Narušující změna	Narušující

Příčina

Obor názvů, jiný než globální obor názvů, obsahuje méně než pět typů.

Popis pravidla

Ujistěte se, že všechny obory názvů mají logické uspořádání a že je vložení typů do řídce zaplněných oborů názvů odůvodněné.Obory názvů by měly obsahovat typy, které se používají ve většině scénářů společně.Pokud je jejich použití vzájemně neslučitelné, měly by být typy v odděleným oborech názvů.Například, obor názvů System.Web.UI obsahuje typy, které se používají ve webových aplikacích a obor názvů System.Windows.Forms obsahuje typy, které se používají v aplikacích založených na Windows.Přestože oba obory názvů obsahují typy, které řídí aspekty uživatelského rozhraní, nejsou tyto typy navrženy pro použití ve stejné aplikaci.Proto jsou umístěny v samostatných oborech názvů.Pečlivá organizace oboru názvů může být užitečná, protože zvyšuje zjistitelnost funkce.Prozkoumáním hierarchie oboru názvů, by uživatelé knihovny měli být schopni vyhledat typy, implementující žádanou funkci.

[!POZNÁMKA]

Typy návrhu a oprávnění by neměly být sloučeny s jinými obory názvů, aby odpovídaly těmto zásadám.Tyto typy patří do svých vlastních oborů názvů, pod hlavním oborem názvů, a měly by končit .Design, případně .Permissions.

Jak vyřešit porušení

Oprava porušení tohoto pravidla, je třeba se pokusit zkombinovat obory názvů, které obsahují pouze několik typů, do jednoho oboru názvů.

Kdy potlačit upozornění

Je bezpečné potlačit upozornění tohoto pravidla, pokud obor názvů neobsahuje typy používané v typech z jiných oborů názvů.