共用方式為


CA1020:避免在命名空間中包含過少的型別

型別名稱

AvoidNamespacesWithFewTypes

CheckId

CA1020

分類

Microsoft.Design

中斷變更

中斷

原因

非全域命名空間的命名空間包含的型別少於五個。

規則描述

請確定每個命名空間都有邏輯組織,而且有合理的原因可以將型別置於以疏鬆方式填入的命名空間中。 命名空間應包含一起用於大部分案例中的型別。 當應用程式為互斥 (Mutually Exclusive) 時,型別應該位於不同的命名空間中。 例如,System.Web.UI 命名空間包含用於 Web 應用程式中的型別,而 System.Windows.Forms 命名空間則包含用於 Windows 架構應用程式中的型別。 雖然這兩個命名空間具有控制使用者介面外觀的型別,這些型別沒有設計用於相同的應用程式。 因此,它們位於不同的命名空間。 嚴謹的命名空間組織可以增加功能的探索能力,所以也是很有幫助的。 藉由檢查命名空間階層,程式庫消費者應能夠找出會實作功能的型別。

注意事項注意事項

不可以將設計階段型別和使用權限合併到其他的命名空間,以符合此方針。這些型別屬於自己的命名空間 (低於您的主要命名空間),而且命名空間應該分別以 .Design 和 .Permissions 做為結尾。

如何修正違規

若要修正此規則的違規情形,請嘗試將包含少數型別的命名空間合併成單一命名空間。

隱藏警告的時機

如果命名空間不包含與其他命名空間中型別一起使用的型別,則您可以放心地隱藏這項規則的警告。