Nombres de miembros de tipos
Actualización: noviembre 2007
Los tipos contienen los tipos siguientes de miembros:
Métodos
Propiedades
Campos
Eventos
Las instrucciones de esta sección ayudan a los diseñadores de bibliotecas de clases a seleccionar nombres para los miembros que sean coherentes con .NET Framework.
Nombres de métodos
Proporcione nombres de métodos que sean verbos o sintagmas verbales.
Normalmente los métodos actúan en datos, por lo que usar un verbo para describir la acción del método facilita a los desarrolladores la comprensión de lo que hace el método. Al definir la acción realizada por el método, tenga cuidado de seleccionar un nombre que proporciona claridad desde el punto de vista del desarrollador. No seleccione un verbo que describa cómo hace el método lo que hace; en otras palabras, no utilice detalles de implementación para el nombre del método.
Nombres de propiedades
Asigne nombres a las propiedades mediante un sustantivo, un sintagma nominal o un adjetivo.
Los sintagmas nominales o los adjetivos son adecuados para las propiedades porque éstas contienen datos.
No utilice propiedades que tengan los mismos nombres que los métodos Get.
Por ejemplo, no utilice un nombre de propiedad EmployeeRecord y denomine también un método GetEmployeeRecord. Los desarrolladores no sabrán qué miembro utilizar para conseguir su tarea de programación.
Considere la posibilidad de dar a una propiedad el mismo nombre que a su tipo.
Cuando se tiene una propiedad con establecimiento inflexible de tipos como enumeración, el nombre de la propiedad puede ser igual que el nombre de la enumeración. Por ejemplo, si tiene una enumeración denominada CacheLevel, una propiedad que devuelve uno de sus valores también se puede denominar CacheLevel.
Nombres de eventos
Utilice dos parámetros denominados sender (remitente) y e en las firmas del controlador de eventos.
El parámetro sender debería ser del tipo Object y el parámetro e una instancia de EventArgs o heredar de ella.
Nombres de campos
Las instrucciones de nomenclatura de campos se aplican a los campos públicos estáticos y protegidos. No debería definir campos de instancia como públicos o protegidos. Para obtener más información, vea Diseño de campos.
No utilice prefijos en los nombres de campos. Por ejemplo, no utilice g_ o s_ para distinguir los campos estáticos de los no estáticos.
Portions Copyright 2005 Microsoft Corporation. Reservados todos los derechos.
Portions Copyright Addison-Wesley Corporation. Reservados todos los derechos.
Para obtener más información sobre las directrices de diseño, consulte el libro titulado "Framework Design Guidelines: Conventions, Idioms, and Patterns for Reusable .NET Libraries" de Krzysztof Cwalina y Brad Abrams, publicado por Addison-Wesley, 2005.
Vea también
Otros recursos
Instrucciones de diseño para desarrollar bibliotecas de clases