CA1724: Názvy typů by se neměly shodovat s obory názvů

Vlastnost Hodnota
ID pravidla CA1724
Název Názvy typů by se neměly shodovat s obory názvů
Kategorie Pojmenování
Oprava způsobující chybu nebo chybu způsobující chybu Narušující
Povoleno ve výchozím nastavení v .NET 8 No

Příčina

Název typu odpovídá odkazovanému názvu oboru názvů, který má jeden nebo více externě viditelných typů. Porovnání názvů nerozlišuje malá a velká písmena.

Popis pravidla

Názvy typů vytvořené uživatelem by neměly odpovídat názvům odkazovaných oborů názvů, které mají externě viditelné typy. Porušení tohoto pravidla může snížit použitelnost knihovny.

Jak opravit porušení

Přejmenujte typ tak, aby se neshodoval s názvem odkazovaného oboru názvů, který má externě viditelné typy.

Kdy potlačit upozornění

Pro nový vývoj nedochází k žádným známým scénářům, ve kterých je nutné potlačit upozornění z tohoto pravidla. Než upozornění potlačíte, pečlivě zvažte, jak mohou být uživatelé vaší knihovny zmateni odpovídajícím názvem. U expediční knihovny může být nutné potlačit upozornění z tohoto pravidla.

Potlačení upozornění

Pokud chcete pouze potlačit jedno porušení, přidejte do zdrojového souboru direktivy preprocesoru, abyste pravidlo zakázali a znovu povolili.

#pragma warning disable CA1724
// The code that's violating the rule is on this line.
#pragma warning restore CA1724

Pokud chcete pravidlo pro soubor, složku nebo projekt zakázat, nastavte jeho závažnost v none konfiguračním souboru.

[*.{cs,vb}]
dotnet_diagnostic.CA1724.severity = none

Další informace naleznete v tématu Jak potlačit upozornění analýzy kódu.

Příklad

namespace MyNamespace
{
    // This class violates the rule
    public class System
    {
    }
}