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, která může být destruktivní nebo nedestruktivní Přerušující
Povoleno ve výchozím nastavení v .NET 10 Ne
Příslušné jazyky C# a Visual Basic

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í

U nového vývoje neexistují žádné známé scénáře, 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 doručovacích knihoven může být nutné potlačit výstrahu 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
    {
    }
}