CA1020: 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.

Tipp

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.

Behandeln von Verstößen

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

Wann sollten Warnungen unterdrückt werden?

Eine Warnung dieser Regel kann gefahrlos unterdrückt werden, wenn der Namespace keine Typen enthält, die mit den Typen in den anderen Namespaces verwendet werden.