Convenciones de nombres

Presentación del tema: "Convenciones de nombres"— Transcripción de la presentación:

1 Convenciones de nombres
Tecnologías de desarrollo IDE Año 2008

2 Un buen estándar de programación considera
Factor mnemotécnico: Para que el programador pueda recordar el nombre de una variable fácilmente. Factor sugestivo: Para que otros programadores puedan leer y entender rápidamente nuestro código. Consistencia: Tiene que ver con usar las mismas convenciones de nomenclatura en todo el programa y hacer que el texto del código sea “legible”.

3 Convenciones Acerca de Nombres de Variables
¡ Se trata sólo del modo de dar un nombre apropiado a las variables ! La convención para los nombres de variables ha de ser automática. Dos personas que usen la misma convención deberían llegar al mismo nombre de variable.

4 Ventajas del uso de estándares
Se puede saber el tipo de dato de cada variable con sólo ver el nombre de la variable. Se puede saber el uso y finalidad de la variable o función fácilmente con solo ver el nombre de la variable. Permite el uso de herramientas automáticas de verificación de Nomenclaturas Poner un nombre a una variable o función será mecánico y automático Asegura la legibilidad del código

5 Convenciones generales
Es preferible la legibilidad a la brevedad Se debería evitar la utilización de identificadores que están en conflicto con palabras clave No conviene utilizar abreviaturas ni contracciones como parte de nombres de identificadores

6 Estándares de programación más comunes
Notación húngara: Consiste en prefijos en minúsculas que se añaden a los nombres de las variables, métodos o funciones y que indican características como su tipo o su ámbito laMes lnMes gcMes También se utiliza en los objetos con los siguientes prefijos: ActiveDoc  acd Label  lbl CheckBox  chk Line  lin ComboBox  cbo ListBox  lst La notación húngara se caracteriza por incluir prefijos en minúsculas que añaden significado a los nombres. En el caso de las variables el prefijo esta formado por 2 caracteres: uno indica el alcance de la variable y el otro, su tipo. En los nombres de objetos el prefijo consta de 3 caracteres.

7 Estándares de programación más comunes
Notación PascalCasing: los identificadores y nombres de variables, métodos y funciones están compuestos por múltiples palabras juntas, iniciando cada palabra con letra mayúscula . DoSomething BackColor

8 Estándares de programación más comunes
Notación camelCasing: Es parecido al Pascal-Casing pero la letra inicial del identificador no debe estar en mayúscula. doSomething backColor

9 Estándares de programación más comunes
Upper Casing: Todas las letras del identificador van en mayúsculas y se separan las palabras con (_) CUSTOMER_ID Lower Casing: Todas las letras del identificador van en minúsculas y se separan las palabras con (_) customer_address

10 Convenciones en .NET framework
Nombres de espacios de nombres : El nombre elegido para un espacio de nombres debería indicar la funcionalidad que proporcionan los tipos incluidos en el espacio de nombres. Los componentes del espacio de nombres se separan con puntos. Ejemplo: el espacio de nombres System.Net.Sockets contiene tipos que permiten a los desarrolladores utilizar sockets para realizar comunicaciones a través de las redes. El formato general <Company>.(<Product>|<Technology>)[.<Feature>][.<Subnamespace>] Por ejemplo, Microsoft.WindowsMobile.DirectX.

11 Convenciones en .NET Nombres de clases, estructuras e interfaces
Los nombres de tipo deberían ser sintagmas nominales, donde el nombre es la entidad representada por el tipo. Por ejemplo, Button, Stack y File Considerar finalizar los nombres de las clases derivadas con el nombre de la clase base. Ejemplo: los tipos del marco de trabajo que heredan de Stream terminan con Stream y tipos que heredan de Exception finalizan con Exception. Al definir un par clase-interfaz en el que la clase es una implementación estándar de la interfaz, nombres sólo se difieren en el prefijo de la letra I (Ejemplo: el marco de trabajo proporciona la interfaz IAsyncResult y la clase AsyncResult)

12 Convenciones en .NET Métodos y Propiedades
Nombres de métodos que sean verbos o sintagmas verbales 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 Nombres de propiedades que sean sustantivo, un sintagma nominal o un adjetivo Un sintagma es una unidad gramatical formada por uno, dos o más elementos lingüísticos que ejercen una única función sintáctica. Sintagmas verbales (sintagmas que poseen como núcleo un verbo). Sintagmas nominales (sintagmas que poseen como núcleo un sustantivo o un pronombre)

13 Convenciones en .NET Eventos y Parámetros
Los eventos tienen que denominarse con un verbo o un sintagma verbal y las clases de argumento de evento con el sufijo EventArgs. Nombres de eventos con un concepto de antes y después, se debe asignar el mismo reflejando el tiempo presente y pasado. Ejemplo, un evento de cierre que se inicie antes de que se cierre una ventana se podría llamar Closing y otro, llamado Closed, que se iniciara después de cerrarse la ventana. Nombres de parámetros descriptivos y aplicar a ellos la grafía tipo Camel. Un buen nombre de parámetro debería indicar los datos o la funcionalidad a los que afecta el parámetro.

14 Convenciones de nomenclatura de Visual Basic .Net
El primer carácter del nombre debe ser un carácter alfabético, un dígito o un subrayado. Empezar cada palabra independiente de un nombre con una letra mayúscula (FindLastRecord, RedrawMyForm). Dentro del nombre no se permite que haya espacios, puntos u otros signos de puntuación. Empezar los nombres de método y de función con un verbo, como en InitNameArray o CloseDialog

15 Convenciones de nomenclatura de Visual Basic .Net
Empezar los nombres de interfaz con el prefijo "I", seguido de un nombre o una frase nominal (Ej: IComponent), o con un adjetivo que describa el comportamiento de la interfaz (Ej: IPersistable) Si se produce un conflicto entre una variable y la palabra clave del mismo nombre, se debe identificar la palabra clave poniendo delante la biblioteca de tipos adecuada. Por ejemplo: variable Date, sólo se puede utilizar la función intrínseca Date llamando a System.Date.

16 Prefijos utilizados en una convención de nombres de variables
Prefijos utilizados en una convención de nombres de variables.para visual basic . Net Prefijo Tipo de variable Str String Int Integer Lng Long Integer Sng Single (Coma flotante de precisión simple) Dbl Double (Coma flotante de precisión doble) Dec Decimal (se suele usar para datos moneda) Bln Boolean Var Variant Byt Byte Col Collection Object Cur Currency Dtm Date(Time) Err Error Obj Object Udt User defined type