Identificadores devem ser escritos corretamente

Artigo
08/25/2010

TypeName	IdentifiersShouldBeSpelledCorrectly
CheckId	CA1704
Category (Categoria)	Microsoft.Naming
Quebrando alterar	Quebrando

Causa

O nome de um identificador visível externamente contém uma ou mais palavras que não são reconhecidas pela biblioteca Microsoft verificador ortográfico.Esta regra não Verifique construtores ou membros chamado especiais, sistema autônomo obter e conjunto sistema autônomo acessadores da propriedade.

Descrição da regra

Esta regra analisa o identificador em tokens e verifica a ortografia de cada token.O algoritmo de análise executa as transformações seguintes:

Letras maiúsculas iniciar um novo token.Por exemplo, MyNameIsJoe divide a "Meus","nome", "É", "Joe".
Para várias letras em maiúsculas, a última letra maiúscula inicia um novo token.Por exemplo, GUIEditor divide a "GUI", "Editor".
entrelinhamento e apóstrofos à direita são removidos.Por exemplo, 'Remetente' divide a "remetente".
Sublinhados significam o participante de um token em são removidos.Por exemplo, Hello_world divide para "Hello", "mundo".
"E" comercial incorporados serão removidos.Por exemplo, para & passe-partout divide "Formatar".

O verificador ortográfico a versão em inglês (en) é usada por padrão.

Como corrigir violações

Para corrigir uma violação dessa regra, corrigir a ortografia da palavra ou adicionar a palavra a um dicionário personalizado chamado CustomDictionary.xml.Coloque o dicionário no diretório de instalação dados ferramenta, o diretório de projeto, ou no diretório de associados com a ferramenta de analisar do usuário (%USERPROFILE%\aplicativo dados\...).

Adicione palavras que não devem causar uma violação no caminho do dicionário/palavras/reconhecidos.
Adicione palavras que devem fazer com que uma violação no caminho do dicionário/palavras/não reconhecido.
Adicione palavras que devem ser sinalizado sistema autônomo obsoleto no caminho do dicionário/palavras/obsoleto.Consulte o tópico relacionado regra "Termos de uso preferencial" para obter mais informações.
Adicionar exceções às regras de diferenciação de maiúsculas e minúsculas acrônimo para o caminho do dicionário/acrônimos/CasingExceptions.

A seguir é um exemplo da estrutura de um arquivo de dicionário personalizado.

   <Dictionary>
      <Words>
         <Unrecognized>
            <Word>cb</Word>
         </Unrecognized>
         <Recognized>
            <Word>stylesheet</Word>
            <Word>GotDotNet</Word>
         </Recognized>
         <Deprecated>
            <Term PreferredAlternate="EnterpriseServices">ComPlus</Term>
         </Deprecated>
      </Words>
      <Acronyms>
         <CasingExceptions>
            <Acronym>CJK</Acronym>
            <Acronym>Pi</Acronym>
         </CasingExceptions>
      </Acronyms>
   </Dictionary>

Quando suprimir avisos

Elimina um aviso esta regra somente se a palavra é intencionalmente com erros de ortografia e a palavra se aplica a um conjunto limitado de biblioteca.Corretamente palavras escritas reduzem a curva de aprendizado necessária para novas bibliotecas de software.