Parâmetros de nomeação

Observação

Este conteúdo é reimpresso com permissão da Pearson Education, Inc. 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 revisado na terceira edição. Algumas das informações nesta página podem estar desatualizadas.

Além do motivo óbvio da legibilidade, é importante seguir as diretrizes para nomes de parâmetros, pois eles são exibidos na documentação e no designer quando as ferramentas de design visual fornecem Intellisense e funcionalidade de navegação de classe.

✔️ USE camelCasing em nomes de parâmetros.

✔️ USE nomes de parâmetro descritivos.

✔️ CONSIDERE o uso de nomes com base no significado de um parâmetro em vez do seu tipo.

Parâmetros de Sobrecarga de Operador de Nomenclatura

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

✔️ USE value para nomes de parâmetro de sobrecarga de operador unário se não houver significado para os parâmetros.

✔️ CONSIDERE nomes significativos para parâmetros de sobrecarga de operador se isso acrescentar um valor significativo.

❌ NÃO use abreviações ou índices numéricos para nomes de parâmetro de sobrecarga de operador.

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

Reimpresso com permissão da Pearson Education, Inc. das Diretrizes de Design do Framework: convenções, linguagens e padrões para bibliotecas do .NET reutilizável, 2ª edição por Krzysztof Cwalina e Brad Abrams, publicado em 22 de outubro de 2008 por Addison-Wesley Professional como parte da série de desenvolvimento do Microsoft Windows.

Confira também