Parâmetros de nomenclatura
Nota
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 para nomes de parâmetros, pois os parâmetros são exibidos na documentação e no designer quando as ferramentas de design visual fornecem Intellisense e funcionalidade de navegação de classe.
✔️ 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 não houver significado para os parâmetros.
✔️ CONSIDERE nomes significativos para parâmetros de sobrecarga do operador se isso agregar valor significativo.
❌ NÃO use abreviaturas ou índices numéricos para nomes de parâmetros de sobrecarga do operador.
© Partes 2005, 2009 Microsoft Corporation. Todos os direitos reservados.
Reimpresso com permissão da Pearson Education, Inc., 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 por Addison-Wesley Professional como parte da Microsoft Windows Development Series.