Asignar nombres a parámetros
Nota:
Este contenido se ha copiado con permiso de Pearson Education, Inc. de Framework Design Guidelines: Conventions, Idioms, and Patterns for Reusable .NET Libraries, 2ª edición. Esa edición se publicó en 2008 y el libro se ha revisado completamente en la tercera edición. Parte de la información de esta página puede estar obsoleta.
Además de la obvia razón de legibilidad, es importante seguir las directrices para los nombres de parámetros porque los parámetros se muestran en la documentación y en el diseñador cuando las herramientas de diseño visual proporcionan IntelliSense y la funcionalidad de exploración de clases.
✔️ USE camelCasing para los nombres de parámetro.
✔️ Use nombres de parámetro descriptivos.
✔️ CONSIDERE la posibilidad de usar nombres basados en el significado de un parámetro en lugar del tipo del parámetro.
Parámetros de sobrecarga del operador de nomenclatura
✔️ Use left y right para los nombres de parámetros de sobrecarga del operador binario si no hay ningún significado para los parámetros.
✔️ Use value para los nombres de parámetros de sobrecarga de operadores unarios si no hay ningún significado para los parámetros.
✔️ CONSIDERE los nombres significativos para los parámetros de sobrecarga del operador si, al hacerlo, se agrega un valor significativo.
❌ NO use abreviaturas o índices numéricos para los nombres de parámetros de sobrecarga del operador.
Portions © 2005, 2009 Microsoft Corporation. Todos los derechos reservados.
Material reimpreso con el consentimiento de Pearson Education, Inc. y extraído de Framework Design Guidelines: Conventions, Idioms, and Patterns for Reusable .NET Libraries, 2nd Edition (Instrucciones de diseño de .NET Framework: convenciones, expresiones y patrones para bibliotecas .NET reutilizables, 2.ª edición), de Krzysztof Cwalina y Brad Abrams, publicado el 22 de octubre de 2008 por Addison-Wesley Professional como parte de la serie Microsoft Windows Development.