Namespaces mit wenigen Typen vermeiden

     TypeName

AvoidNamespacesWithFewTypes

CheckId

CA1020

Kategorie

Microsoft.Design

Unterbrechende Änderung

Breaking

Ursache

Ein anderer Namespace als der globale Namespace enthält weniger als fünf Typen.

Regelbeschreibung

Stellen Sie sicher, dass jeder der Namespaces logisch organisiert ist und dass es einen zulässigen Grund dafür gibt, Typen in einen wenig gefüllten Namespace einzufügen. Namespaces sollten Typen enthalten, die in den meisten Szenarien zusammen verwendet werden. Wenn die Anwendungen sich gegenseitig ausschließen, sollten sich die Typen in separaten Namespaces befinden. Der System.Web.UI-Namespace enthält z. B. Typen, die in Webanwendungen verwendet werden, während der System.Windows.Forms-Namespace Typen enthält, die in Windows-basierten Anwendungen verwendet werden. Obwohl beide Namespaces Typen enthalten, die Aspekte der Benutzeroberfläche steuern, sind diese Typen nicht für die Verwendung in der gleichen Anwendung vorgesehen und befinden sich daher in separaten Namespaces. Eine sorgfältige Organisation der Namespaces kann auch hilfreich sein, da sich Features dadurch leichter auffinden lassen. Bibliotheksconsumer sollten durch Prüfung der Namespacehierarchie in der Lage sein, die Typen zu finden, die ein Feature implementieren.

Hinweis

Zur Einhaltung dieser Richtlinie sollten Entwurfszeittypen und Berechtigungen nicht in andere Namespaces integriert werden. Diese Typen gehören in ihre eigenen Namespaces unterhalb des Hauptnamespaces, und die Namespaces sollten auf .Design bzw. .Permissions enden.

Behandlung von Verstößen

Um einen Verstoß gegen diese Regel zu beheben, versuchen Sie, Namespaces, die nur wenig Typen enthalten, zu einem einzigen Namespace zusammenzufassen.

Warnungsausschluss

Eine Warnung dieser Regel kann gefahrlos ausgeschlossen werden, wenn der Namespace keine Typen enthält, die mit den Typen in den anderen Namespaces verwendet werden. Ein Verstoß kann auch dann gefahrlos ausgeschlossen werden, wenn die Bibliothek weniger als fünf Typen enthält.