CA1724:類型名稱不應符合命名空間
屬性 | 值 |
---|---|
規則識別碼 | CA1724 |
職稱 | 類型名稱不得與命名空間相符 |
類別 | 命名 |
修正程式是中斷或非中斷 | 中斷 |
預設在 .NET 9 中啟用 | No |
原因
類型名稱符合具有一或多個外部可見型別的參考命名空間名稱。 名稱比較不區分大小寫。
檔案描述
使用者建立的類型名稱不應符合具有外部可見型別的參考命名空間名稱。 違反此規則可減少連結庫的可用性。
如何修正違規
重新命名類型,使其不符合具有外部可見型別的參考命名空間名稱。
隱藏警告的時機
針對新開發,不會發生必須隱藏此規則警告的已知情節。 在隱藏警告之前,請仔細考慮連結庫的使用者如何因相符名稱而混淆。 若要交付程式庫,您可能必須隱藏此規則的警告。
隱藏警告
如果您只想要隱藏單一違規,請將預處理器指示詞新增至原始程式檔以停用,然後重新啟用規則。
#pragma warning disable CA1724
// The code that's violating the rule is on this line.
#pragma warning restore CA1724
若要停用檔案、資料夾或項目的規則,請在組態檔中將其嚴重性設定為 。none
[*.{cs,vb}]
dotnet_diagnostic.CA1724.severity = none
如需詳細資訊,請參閱 如何隱藏程式代碼分析警告。
範例
namespace MyNamespace
{
// This class violates the rule
public class System
{
}
}