Partilhar via


Regras de nomenclatura

As regras de nomenclatura oferecem suporte à adesão às convenções de nomenclatura das diretrizes de design do .NET.

Nesta secção

Regra Descrição
CA1700: Não nomeie valores de enum como 'Reservado' Esta regra pressupõe que um membro de enumeração que tenha um nome que contenha "reservado" não é usado atualmente, mas é um espaço reservado a ser renomeado ou removido em uma versão futura. Renomear ou remover um membro é uma alteração significativa.
CA1707: Os identificadores não devem conter sublinhados Por convenção, os nomes dos identificadores não contêm o caractere sublinhado (_). Esta regra verifica namespaces, tipos, membros e parâmetros.
CA1708: Os identificadores devem diferir por mais do que apenas a diferença entre maiúsculas e minúsculas Os identificadores para namespaces, tipos, membros e parâmetros não podem diferir apenas por maiúsculas e minúsculas porque as linguagens destinadas ao Common Language Runtime não são obrigadas a serem sensíveis a maiúsculas e minúsculas.
CA1710: Os identificadores devem ter o sufixo correto Por convenção, os nomes dos tipos que estendem certos tipos base ou que implementam determinadas interfaces, ou tipos derivados desses tipos, têm um sufixo associado ao tipo base ou interface.
CA1711: Os identificadores não devem ter sufixo incorreto Por convenção, apenas os nomes de tipos que estendem certos tipos base ou que implementam certas interfaces, ou tipos derivados desses tipos, devem terminar com sufixos reservados específicos. Outros nomes de tipo não devem usar esses sufixos reservados.
CA1712: Não prefixe valores de enum com o nome do tipo Os nomes dos membros da enumeração não são prefixados com o nome do tipo porque as informações de tipo devem ser fornecidas pelas ferramentas de desenvolvimento.
CA1713: Os eventos não devem ter antes ou depois do prefixo O nome de um evento começa com "Antes" ou "Depois". Para nomear eventos relacionados que são gerados em uma sequência específica, use o tempo presente ou passado para indicar a posição relativa na sequência de ações.
CA1714: Enums de bandeiras devem ter nomes plurais Uma enumeração pública tem o atributo System.FlagsAttribute e seu nome não termina em "s". Os tipos marcados com FlagsAttribute têm nomes que são plurais porque o atributo indica que mais de um valor pode ser especificado.
CA1715: Os identificadores devem ter o prefixo correto O nome de uma interface visível externamente não começa com um "I" maiúsculo. O nome de um parâmetro de tipo genérico em um tipo ou método visível externamente não começa com um "T" maiúsculo.
CA1716: Os identificadores não devem corresponder a palavras-chave Um nome de namespace ou um nome de tipo corresponde a uma palavra-chave reservada em uma linguagem de programação. Os identificadores para namespaces e tipos não devem corresponder a palavras-chave definidas por linguagens que visam o Common Language Runtime.
CA1717: Somente enums FlagsAttribute devem ter nomes plurais As convenções de nomenclatura determinam que um nome plural para uma enumeração indica que mais de um valor da enumeração pode ser especificado ao mesmo tempo.
CA1720: Os identificadores não devem conter nomes de tipo 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ífico do idioma.
CA1721: Os nomes de propriedade não devem corresponder aos métodos get O nome de um membro público ou protegido começa com "Get" e corresponde ao nome de uma propriedade pública ou protegida. Os métodos e propriedades "Get" devem ter nomes que distingam claramente sua função.
CA1724: Nomes de tipo não devem corresponder a namespaces Os nomes de tipo não devem corresponder aos nomes de namespaces .NET. A violação desta regra pode reduzir a usabilidade da biblioteca.
CA1725: Os nomes dos parâmetros devem corresponder à declaração base A nomenclatura consistente de parâmetros em uma hierarquia de substituição aumenta a usabilidade das substituições de método. Um nome de parâmetro em um método derivado que difere do nome na declaração base pode causar confusão sobre se o método é uma substituição do método base ou uma nova sobrecarga do método.
CA1727: Use PascalCase para espaços reservados com nomes Utilize PascalCase para espaços reservados nomeados no modelo de mensagem de log.