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 9 | 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
{
}
}