CA1708: Identificadores devem ser diferentes em algo além das maiúsculas e minúsculas

  • Artigo
Property Valor
ID da regra CA1708
Título Identificadores devem ser diferentes em algo além das maiúsculas e minúsculas
Categoria Nomenclatura
Correção interruptiva ou sem interrupção Quebra
Habilitado por padrão no .NET 8 Não

Causa

Os nomes de dois tipos, membros, parâmetros ou namespaces totalmente qualificados são idênticos quando convertidos em letras minúsculas.

Por padrão, essa regra analisa apenas os tipos, membros e namespaces externamente visíveis, mas isso é configurável.

Descrição da regra

Os identificadores de namespaces, tipos, membros e parâmetros não podem se diferenciar apenas por maiúsculas porque linguagens com o Common Language Runtime como destino não precisam diferenciar maiúsculas e minúsculas. Por exemplo, o Visual Basic é uma linguagem amplamente usada que não diferencia maiúsculas de minúsculas.

Como corrigir violações

Selecione um nome que seja exclusivo quando comparado a outros identificadores, sem diferenciação de maiúsculas e minúsculas.

Quando suprimir avisos

Não suprima um aviso nessa regra. A biblioteca pode não ser utilizável em todas as linguagens disponíveis no .NET.

Configurar códigos para análise

Use a opção a seguir para configurar em quais partes da base de código essa regra deve ser executada.

Você pode configurar essa opção apenas para essa regra, para todas as regras às quais ela se aplica ou para todas as regras nessa categoria (Nomenclatura) às quais ela se aplica. Para saber mais, confira Opções de configuração de regra de qualidade de código.

Incluir superfícies de API específicas

É possível configurar em quais partes da base de código essa regra deverá ser executada, com base na acessibilidade. Por exemplo, para especificar que a regra deverá ser executada apenas na superfície de API não pública, adicione o seguinte par chave-valor a um arquivo .editorconfig no projeto:

dotnet_code_quality.CAXXXX.api_surface = private, internal

Exemplo de violação

O exemplo a seguir demonstra uma violação dessa regra.

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

O exemplo a seguir mostra uma maneira de corrigir a violação

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