CA1708: Os identificadores devem diferir mais do que maiúsculas e minúsculas
| Property | valor |
|---|---|
| ID da regra | CA1708 |
| Título | Os identificadores devem diferir mais do que maiúsculas |
| Categoria | Atribuição de nomes |
| A correção está quebrando ou não quebrando | Quebrando |
| Habilitado por padrão no .NET 9 | Não |
Motivo
Os nomes de dois tipos, membros, parâmetros ou namespaces totalmente qualificados são idênticos quando são convertidos em minúsculas.
Por padrão, essa regra examina apenas tipos, membros e namespaces visíveis externamente, mas isso é configurável.
Descrição da regra
Os identificadores para namespaces, tipos, membros e parâmetros não podem diferir apenas por maiúsculas e minúsculas porque as linguagens destinadas ao Common Language Runtime não precisam diferenciar maiúsculas de minúsculas. Por exemplo, Visual Basic é uma linguagem que não diferencia maiúsculas de minúsculas amplamente utilizada.
Como corrigir violações
Selecione um nome que seja exclusivo quando comparado a outros identificadores de maneira que não diferencie maiúsculas de minúsculas.
Quando suprimir avisos
Não suprima um aviso desta regra. A biblioteca pode não ser utilizável em todos os idiomas disponíveis no .NET.
Configurar código para análise
Use a opção a seguir para configurar em quais partes da sua base de código executar essa regra.
Você pode configurar essa opção apenas para esta regra, para todas as regras às quais ela se aplica ou para todas as regras nesta categoria (Nomenclatura) às quais ela se aplica. Para obter mais informações, consulte Opções de configuração da regra de qualidade de código.
Incluir superfícies de API específicas
Você pode configurar em quais partes da sua base de código executar essa regra, com base em sua acessibilidade. Por exemplo, para especificar que a regra deve ser executada somente na superfície de API não pública, adicione o seguinte par chave-valor a um arquivo .editorconfig em seu projeto:
dotnet_code_quality.CAXXXX.api_surface = private, internal
Exemplo de uma 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;
}
