CA2204: Literais devem ser escritos corretamente

  • Artigo
Item Valor
RuleId CA2204
Categoria Microsoft.Usage
Alteração da falha Sem interrupção

Causa

Uma cadeia de caracteres literal é passada como um argumento para um parâmetro localizável ou para uma propriedade localizável e a cadeia de caracteres contém uma ou mais palavras que não são reconhecidas pela biblioteca de verificação ortográfica da Microsoft.

Descrição da regra

Essa regra verifica uma cadeia de caracteres de literal que é passada como um valor para um parâmetro ou uma propriedade quando um ou mais dos seguintes casos são verdadeiros:

  • O atributo LocalizableAttribute do parâmetro ou da propriedade é definido como true.

  • O nome do parâmetro ou da propriedade contém "Text", "Message" ou "Caption".

  • O nome da variável da cadeia de caracteres passada para um método Write ou WriteLine() é "value" ou "format".

Essa regra analisa a cadeia de caracteres de literal em palavras, gerando tokens de palavras compostas, e verifica a ortografia de cada palavra ou token. Para obter informações sobre o algoritmo de análise, consulte CA1704: Identificadores devem ser escritos corretamente.

Linguagem

Atualmente, o verificador ortográfico verifica apenas os dicionários de cultura baseados em inglês. Você pode alterar a cultura do projeto no arquivo de projeto, adicionando o elemento CodeAnalysisCulture.

Por exemplo:

<Project ...>
  <PropertyGroup>
    <CodeAnalysisCulture>en-AU</CodeAnalysisCulture>

Importante

Se você definir a cultura como algo diferente de uma cultura baseada em inglês, essa regra de análise de código será desabilitada silenciosamente.

Como corrigir violações

Para corrigir uma violação dessa regra, corrija a ortografia da palavra ou adicione a palavra a um dicionário personalizado. Para obter informações sobre como usar dicionários personalizados, consulte Como personalizar o dicionário do Code Analysis.

Quando suprimir avisos

Não suprima um aviso nessa regra. Palavras escritas corretamente reduzem a curva de aprendizado necessária nas novas bibliotecas de software.