Identificadores devem ser causados corretamente
TypeName |
IdentifiersShouldBeCasedCorrectly |
CheckId |
CA1709 |
Category (Categoria) |
Microsoft.Naming |
Quebrando alterar |
Quebrando - quando acionado em 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 em minúsculas.
- 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 uma aparência comum para bibliotecas de destino o common linguagem tempo de execução.Isso reduz a curva de aprendizado necessária para novas bibliotecas de software e aumenta a confiança do cliente que a biblioteca foi desenvolvida por uma pessoa com experiência em desenvolvimento de código gerenciado.
Por convenção, os nomes de parâmetro usam camel casing; espaço para nome, tipo e o membro use Pascal casing.Um nome causado camel, a primeira letra é em minúsculas e a primeira letra de todas as palavras restantes no nome é em letras maiúsculas.São exemplos de casos camel nomes "packetSniffer", "ioFile" e "fatalErrorCode".Um nome causado Pascal, a primeira letra é maiúscula e a primeira letra de todas as palavras restantes no nome é em letras maiúsculas.São exemplos de casos Pascal nomes "PacketSniffer", "IOFile" e "FatalErrorCode".
Esta regra divide o nome em palavras com base no uso de maiúsculas e minúsculas e verifica sistema autônomo palavras de duas letras em relação a uma lista de palavras de duas letras comuns, sistema autônomo "Em" ou "Meu".Se não for encontrada uma correspondência, a palavra é considerada um acrônimo.Além disso, essa regra pressupõe que 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 participante do nome.
Por convenção, acrônimos de duas letras usam letras maiúsculas e acrônimos de três ou mais caracteres usam Pascal casing.Os exemplos a seguir está de acordo com essa convenção de nomeclatura: 'Banco de dados', 'CR', 'Cpa' e 'Ecma'.Os exemplos a seguir violam a convenção: 'Io', 'XML' e 'DoD' e para nomes de parâmetro não, 'xp' e 'cpl'.
'ID' é casos especiais para causar uma violação desta regra. 'ID 'não é um acrônimo mas é uma abreviação de' identificação '.A abreviação 'OK' é outro caso especial que causará uma violação desta regra.Bem treinados devem ser abreviado sistema autônomo 'Ok' para evitar violam essa regra.
Como corrigir violações
Altere o nome de modo que ele é causado corretamente.
Quando suprimir avisos
É seguro suprimir este aviso se você tiver seus próprio convenções de nomeação ou se o identificador representa um nome apropriado, por exemplo, o nome de uma empresa ou uma tecnologia.
Regras relacionadas
Identificadores devem diferir por mais de caso