Compartilhar via


CA1720: Identificadores não devem conter nomes de tipo

TypeName

IdentifiersShouldNotContainTypeNames

CheckId

CA1720

<strong>Categoria</strong>

Microsoft.Naming

Alteração significativa

Quebrando

Causa

O nome de um parâmetro em 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 a serem fornecidos pelas ferramentas de desenvolvimento.Nomes de membros, se deve ser usado um nome de tipo de dados, use um nome independente de linguagem em vez de um idioma específico.Por exemplo, em vez do 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 linguagem, 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 independente de linguagem 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 ocorrem onde você deve eliminar um aviso esta regra.Para bibliotecas que têm anterior fornecido, talvez seja necessário 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 membros