CA1709: Identificadores devem ter maiúsculas e minúsculas corretasCA1709: Identifiers should be cased correctly

ItemItem ValorValue
RuleIdRuleId CA1709CA1709
CategoriaCategory Microsoft. NamingMicrosoft.Naming
Alteração interruptivaBreaking change Quebra-quando gerado em assemblies, namespaces, tipos, membros e parâmetros.Breaking - when raised on assemblies, namespaces, types, members, and parameters.

Não separável-quando acionado em parâmetros de tipo genérico.Non-breaking - when fired on generic type parameters.

CausaCause

O nome de um identificador não está em maiúsculas corretamente.The name of an identifier is not cased correctly.

- ou –- or -

O nome de um identificador contém um acrônimo de duas letras e a segunda letra é minúscula.The name of an identifier contains a two-letter acronym and the second letter is lowercase.

- ou –- or -

O nome de um identificador contém um acrônimo de três ou mais letras maiúsculas.The name of an identifier contains an acronym of three or more uppercase letters.

Descrição da regraRule description

As convenções de nomenclatura fornecem uma aparência comum para as bibliotecas direcionadas ao Common Language Runtime.Naming conventions provide a common look for libraries that target the common language runtime. Essa consistência reduz a curva de aprendizado necessária para novas bibliotecas de software e aumenta a confiança do cliente de que a biblioteca foi desenvolvida por alguém que tenha experiência no desenvolvimento de código gerenciado.This consistency reduces the learning curve that's required for new software libraries, and increases customer confidence that the library was developed by someone who has expertise in developing managed code.

Por convenção, os nomes de parâmetro usam o camel case, e os nomes de namespace, tipo e membro usam a embalagem do Pascal.By convention, parameter names use camel casing, and namespace, type, and member names use Pascal casing. Em um nome de camel case, a primeira letra é minúscula e a primeira letra de qualquer palavra restante no nome é maiúscula.In a camel-cased name, the first letter is lowercase, and the first letter of any remaining words in the name is uppercase. Exemplos de nomes de camel-case são packetSniffer , ioFile e fatalErrorCode .Examples of camel-cased names are packetSniffer, ioFile, and fatalErrorCode. Em um nome em Pascal, a primeira letra é maiúscula e a primeira letra das palavras restantes no nome é maiúscula.In a Pascal-cased name, the first letter is uppercase, and the first letter of any remaining words in the name is uppercase. Exemplos de nomes de Pascal-case são PacketSniffer , IOFile e FatalErrorCode .Examples of Pascal-cased names are PacketSniffer, IOFile, and FatalErrorCode.

Essa regra divide o nome em palavras com base na capitalização e verifica quaisquer palavras de duas letras em uma lista de palavras de duas letras comuns, como "in" ou "My".This rule splits the name into words based on the casing and checks any two-letter words against a list of common two-letter words, such as "In" or "My". Se uma correspondência não for encontrada, presume-se que a palavra seja um acrônimo.If a match is not found, the word is assumed to be an acronym. Além disso, essa regra pressupõe que ela encontrou um acrônimo quando o nome contém quatro letras maiúsculas em uma linha ou três letras maiúsculas em uma linha no final do nome.In addition, this rule assumes it has found an acronym when the name contains either four uppercase letters in a row or three uppercase letters in a row at the end of the name.

Por convenção, os acrônimos de duas letras usam todas as letras maiúsculas e os acrônimos de três ou mais caracteres usam a capitalização de Pascal.By convention, two-letter acronyms use all uppercase letters, and acronyms of three or more characters use Pascal casing. Os exemplos a seguir usam essa Convenção de nomenclatura: ' DB ', ' CR ', ' contador ' e ' ECMA '.The following examples use this naming convention: 'DB', 'CR', 'Cpa', and 'Ecma'. Os exemplos a seguir violam a Convenção: ' Io ', ' XML ' e ' DoD ' e para nomes de não parâmetros, ' XP ' e ' CPL '.The following examples violate the convention: 'Io', 'XML', and 'DoD', and for non-parameter names, 'xp' and 'cpl'.

' ID ' é especial para causar uma violação dessa regra.'ID' is special-cased to cause a violation of this rule. ' ID ' não é um acrônimo, mas é uma abreviação para ' identificação '.'Id' is not an acronym but is an abbreviation for 'identification'.

Como corrigir violaçõesHow to fix violations

Altere o nome para que ele esteja em maiúsculas e minúsculas.Change the name so that it is cased correctly.

Quando suprimir avisosWhen to suppress warnings

É seguro suprimir esse aviso se você tiver suas próprias convenções de nomenclatura ou se o identificador representar um nome adequado, por exemplo, o nome de uma empresa ou uma tecnologia.It is safe to suppress this warning if you have your own naming conventions, or if the identifier represents a proper name, for example, the name of a company or a technology.

Você também pode adicionar termos, abreviações e acrônimos específicos a um dicionário personalizado de análise de código.You can also add specific terms, abbreviations, and acronyms that to a code analysis custom dictionary. Os termos especificados no dicionário personalizado não causarão violações dessa regra.Terms specified in the custom dictionary will not cause violations of this rule. Para obter mais informações, consulte como: personalizar o dicionário de análise de código.For more information, see How to: Customize the Code Analysis Dictionary.

CA1708: Identificadores devem ser diferentes em algo além das maiúsculas e minúsculasCA1708: Identifiers should differ by more than case