Partilhar via


Parâmetros de nomenclatura

Observação

Este conteúdo é reimpresso com permissão da Pearson Education, Inc., a partir de Framework Design Guidelines: Conventions, Idioms, and Patterns for Reusable .NET Libraries, 2nd Edition. Essa edição foi publicada em 2008 e, desde então, o livro foi totalmente revisto na terceira edição. Algumas das informações nesta página podem estar desatualizadas.

Além da razão óbvia da legibilidade, é importante seguir as diretrizes de nomenclatura de parâmetros, pois os parâmetros são exibidos na documentação e no editor de design quando as ferramentas de design visual fornecem Intellisense e funcionalidade de navegação entre classes.

✔️ DO use camelCasing em nomes de parâmetros.

✔️ DO use nomes de parâmetros descritivos.

✔️ CONSIDERE usar nomes baseados no significado de um parâmetro em vez do tipo do parâmetro.

Nomeando parâmetros de sobrecarga do operador

✔️ DO use left e right para nomes de parâmetros de sobrecarga de operador binário se não houver significado para os parâmetros.

✔️ DO use value para nomes de parâmetros de sobrecarga do operador unário se os parâmetros não tiverem significado.

✔️ CONSIDERE atribuir nomes significativos aos parâmetros de sobrecarga de operadores se isso agregar valor significativo.

❌ NÃO use abreviaturas ou índices numéricos para nomes de parâmetros de sobrecarga do operador.

© Trechos 2005, 2009 Microsoft Corporation. Todos os direitos reservados.

Reimpresso com permissão da Pearson Education, Inc., a partir de Framework Design Guidelines: Conventions, Idioms, and Patterns for Reusable .NET Libraries, 2nd Edition por Krzysztof Cwalina e Brad Abrams, publicado em 22 de outubro de 2008 pela Addison-Wesley Professional como parte da Microsoft Windows Development Series.

Ver também