Partilhar via

CA1720: Identificadores não devem conter os nomes de tipo

  • Artigo

TypeName

IdentifiersShouldNotContainTypeNames

CheckId

CA1720

<strong>Categoria</strong>

Microsoft.Naming

Alteração significativa

Quebrando

Causa

O nome de um parâmetro de um membro visível externamente contém um nome de tipo de dados.

- ou -

O nome de um membro visível externamente contém um nome de tipo de dados específicos do idioma.

Descrição da regra

Nomes de parâmetros e os membros são melhor usados para se comunicar seu significado que descrevem o seu tipo, o que é esperado para ser fornecidos pelas ferramentas de desenvolvimento. Para nomes de membros, se deve ser usado um nome de tipo de dados, usam um nome independente de linguagem em vez de um idioma específico. Por exemplo, em vez de C# tipo nome 'int', use o nome de tipo de dados independente de linguagem, Int32.

Cada token discreto no nome do parâmetro ou membro é comparado com os seguintes nomes de tipo de dados específicos do idioma, de uma maneira de maiúsculas e minúsculas:

  • Bool

  • WChar

  • Int8

  • UInt8

  • Short

  • UShort

  • int

  • UInt

  • Integer

  • UInteger

  • Long

  • ULong

  • Não assinado

  • Assinado

  • Float

  • Float32

  • Float64

Além disso, os nomes de um parâmetro também são verificados contra os seguintes nomes de tipo de dados independente de idioma, de uma maneira de maiúsculas e minúsculas:

  • Object

  • Obj

  • Boolean

  • Char

  • String

  • SByte

  • Byte

  • UByte

  • Int16

  • UInt16

  • Int32

  • UInt32

  • Int64

  • UInt64

  • IntPtr

  • PTR

  • Ponteiro

  • UInptr

  • UPtr

  • UPointer

  • Simples

  • Double

  • Decimal

  • GUID

Como corrigir violações

Se acionado contra um parâmetro:

Substitua o identificador de tipo de dados no nome do parâmetro com um termo que descreve melhor o seu significado ou um termo mais genérico, como, por exemplo, 'value'.

Se acionado contra um membro:

Substitua o identificador de tipo de dados específicos do idioma no nome do membro com um termo que descreve melhor o seu significado, um equivalente de linguagem independente ou um termo mais genérico, como, por exemplo, 'value'.

Quando suprimir avisos

Uso ocasional de nomes de parâmetro e membro tipo pode ser apropriado. No entanto, para o desenvolvimento de novos, sem conhecidos cenários ocorrerem onde você deve eliminar um aviso esta regra. Para bibliotecas que têm fornecido anterior, você pode ter que eliminar um aviso esta regra.

Regras relacionadas

CA1709: Identificadores devem ser minúsculas corretamente

CA1708: Identificadores devem diferir por mais de caso

CA1707: Identificadores não devem conter sublinhados

CA1719: Nomes de parâmetro não devem corresponder a nomes de membro