CA1709: Identificadores devem ser minúsculas corretamente
TypeName |
IdentifiersShouldBeCasedCorrectly |
CheckId |
CA1709 |
<strong>Categoria</strong> |
Microsoft.Naming |
Alteração significativa |
Quebrando - quando aumentado em módulos (assemblies), namespaces, tipos, membros e parâmetros. Não-separável - quando acionado em parâmetros de tipo genérico. |
Causa
O nome de um identificador não é causado corretamente.
- ou -
O nome de um identificador contém um acrônimo de duas letras e a segunda letra fique em minúscula.
- ou -
O nome de um identificador contém um acrônimo de três ou mais letras maiúsculas.
Descrição da regra
Convenções de nomenclatura fornecem um aspecto familiar a bibliotecas que se destinam ao uso com a common language runtime.Isso reduz a curva de aprendizado que é necessário para novas bibliotecas de software e aumenta a confiança do cliente que a biblioteca foi desenvolvida por alguém que tenha experiência em desenvolvimento de código gerenciado.
Por convenção, os nomes de parâmetro usam camel casing; os nomes de espaço para nome, tipo e membro usam Pascal casing.Um nome concatenados, a primeira letra é minúscula e a primeira letra das palavras no nome do restantes é em letras maiúsculas.Exemplos de nomes concatenados são "packetSniffer", "ioFile" e "fatalErrorCode".Um nome de minúsculas de Pascal, a primeira letra é maiúscula e a primeira letra das palavras no nome do restantes é em letras maiúsculas.Exemplos de nomes de minúsculas de Pascal são "PacketSniffer", "IOFile" e "FatalErrorCode".
Esta regra divide o nome em palavras com base em que o uso de maiúsculas e verifica todas as palavras em uma lista de palavras de duas letras comuns, como "In" ou "Meu" duas letras.Se não houver uma correspondência, a palavra é considerada um acrônimo.Além disso, essa regra pressupõe encontrou um acrônimo quando o nome contém quatro letras maiúsculas em uma linha de um ou três letras maiúsculas em uma linha no final do nome.
Por convenção, acrônimos de duas letras usam letras maiúsculas e acrônimos de três ou mais caracteres Pascal casing.Os exemplos seguintes usam essa convenção de nomenclatura: 'DB', 'CR', 'Cpa' e 'Ecma'.Os exemplos a seguir violam a convenção: 'Io', 'XML' e 'DoD' e para os nomes de nonparameter, 'xp' e 'Painel de controle'.
'ID' é causado em especial para causar uma violação desta regra. 'ID' não é um acrônimo mas é uma abreviação de 'identificação'.
Como corrigir violações
Altere o nome para que ele é causado corretamente.
Quando suprimir avisos
É seguro suprimir este aviso, se você tiver seus próprio convenções de nomenclatura, ou se o identificador representa um nome apropriado, por exemplo, o nome de uma empresa ou uma tecnologia.
Você também pode adicionar termos específicos, abreviações e acrônimos que a um dicionário personalizado de análise de código.Termos especificados no dicionário personalizado não irá causar violações desta regra.Para mais informações, consulte: Como: personalizar o dicionário de análise de código.