Nomes de parâmetros
Escolher nomes adequados para os parâmetros poderá melhorar a usabilidade de sua biblioteca de forma significativa. Um nome adequado de parâmetro deve indicar quais dados ou funcionalidades é afetada pelo parâmetro.
Usar casing Camel em nomes de parâmetro.
Use nomes descritivos de parâmetro.
Na maioria dos cenários, o nome do parâmetro e seu tipo deve ser suficiente para determinar o uso do parâmetro.
Considere usar nomes com base em seu significado em vez de nomes baseado no tipo do parâmetro.
Em Ferramentas do desenvolvedor e documentação, o tipo do parâmetro é normalmente visível. Ao selecionar um nome que descreva o uso ou significado do parâmetro, você dá aos desenvolvedores informações importantes que ajudam identificar membros certos para suas tarefas e os dados certos para passar para o membro.
Portions Copyright 2005 Microsoft Corporation. Todos os direitos reservados.
Portions Copyright Addison-Wesley Corporation. Todos os direitos reservados.
Para obter mais informações sobre as diretrizes de design, consulte a "diretrizes de Design do Framework: Convenções, idiomas e padrões de reutilizável.Bibliotecas de rede" catálogo por Krzysztof Cwalina e Brad Abrams, publicado pela Addison-Wesley, 2005.
Consulte também
Outros recursos
Diretrizes de Design para desenvolvimento bibliotecas de classe