CA1708: Identifikátory by se měly lišit více než použitím malých a velkých písmen

Vlastnost	Hodnota
ID pravidla	CA1708
Název	Identifikátory by se měly lišit více než použitím malých a velkých písmen
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ázvy dvou typů, členů, parametrů nebo plně kvalifikovaných oborů názvů jsou při převodu na malá písmena stejné.

Ve výchozím nastavení toto pravidlo sleduje jenom externě viditelné typy, členy a obory názvů, ale dá se konfigurovat.

Popis pravidla

Identifikátory pro obory názvů, typy, členy a parametry nelze odlišit pouze ve velikosti písmen, protože jazyky cílené na modul CLR (Common Language Runtime) nemusí rozlišovat malá a velká písmena. Visual Basic je například široce používaný jazyk nerozlišující malá a velká písmena.

Jak opravit porušení

Vyberte název, který je jedinečný, když se porovná s jinými identifikátory bez rozlišování malých a velkých písmen.

Kdy potlačit upozornění

Nepotlačujte upozornění na toto pravidlo. Knihovna nemusí být použitelná ve všech dostupných jazycích v .NET.

Konfigurace kódu pro analýzu

Pomocí následující možnosti nakonfigurujte, ve kterých částech základu kódu se má toto pravidlo spouštět.

• Zahrnutí konkrétních povrchů rozhraní API

Tuto možnost můžete nakonfigurovat jenom pro toto pravidlo, pro všechna pravidla, která platí, nebo pro všechna pravidla v této kategorii (pojmenování), na která platí. Další informace naleznete v tématu Možnosti konfigurace pravidla kvality kódu.

Zahrnutí konkrétních povrchů rozhraní API

Nastavením možnosti api_surface můžete nakonfigurovat, na kterých částech základu kódu se má toto pravidlo spouštět na základě jejich přístupnosti. Pokud chcete například určit, že pravidlo by se mělo spouštět jenom na neveřejné ploše rozhraní API, přidejte do souboru .editorconfig v projektu následující pár klíč-hodnota:

dotnet_code_quality.CAXXXX.api_surface = private, internal

Poznámka

Nahraďte XXXX část CAXXXX ID příslušného pravidla.

Příklad porušení

Následující příklad ukazuje porušení tohoto pravidla.

public class Class1
{
    protected string someName;
    public string SomeName => someName;
}

Následující příklad ukazuje jeden ze způsobů, jak opravit porušení předpisů.

public class Class1
{
    protected string _someName;
    public string SomeName => _someName;
}