nomenclaturas - buenas practicas
TRANSCRIPT
![Page 1: Nomenclaturas - Buenas Practicas](https://reader036.vdocumento.com/reader036/viewer/2022082408/5571fb17497959916993ebf4/html5/thumbnails/1.jpg)
Buenas Prácticasde Programación
![Page 2: Nomenclaturas - Buenas Practicas](https://reader036.vdocumento.com/reader036/viewer/2022082408/5571fb17497959916993ebf4/html5/thumbnails/2.jpg)
Introducción
• Recordar realizar una codificación clara y concisa, utilizando toda la potencia que proporciona el lenguaje.
• No utilizar campos públicos: deben ser siempre privados a una clase y si se deben exponer se deben mostrar a través de una propiedad.
• Utilizar los elementos del lenguaje según su propósito. Por ejemplo, no utilizar una propiedad para realizar una operatoria compleja ya que no se creó para tal fin: se debe usar un método.
• Ante la duda, dirigirse a la documentación (Guías de buenas prácticas o la propia ayuda del .NET)
![Page 3: Nomenclaturas - Buenas Practicas](https://reader036.vdocumento.com/reader036/viewer/2022082408/5571fb17497959916993ebf4/html5/thumbnails/3.jpg)
Capitalización
Hay cuatro maneras de manejar las mayúsculas en las palabras de los elementos del lenguaje:
• Camel: se escribe la primera letra en minúscula, y las siguientes componentes del nombre en mayúsculas. Ej: cuentaCorriente, cajaAhorro, personaFisica.
• Pascal: se escriben las letras iniciales componentes del nombre enmayúsculas. Ej: PersonaJuridica, ImpresoraLaser.
• Húngara: se coloca un prefijo indicando el tipo y luego el nombre del elemento, con mayúscula en las palabras constitutivas del nombre del elemento. Ej: strPalabra (string), intCantidadRecibidos (entero).
• Mayúsculas: toda la palabra se escribe con letras mayúsculas: se usa mucho para abreviaturas y acrónimos bien conocidos. Ej: System.Web.UI, System.IO.
La notación Húngara no la utilizamos.
![Page 4: Nomenclaturas - Buenas Practicas](https://reader036.vdocumento.com/reader036/viewer/2022082408/5571fb17497959916993ebf4/html5/thumbnails/4.jpg)
Capitalización: Reglas Generales Portal Autogestión Individuos
• No crear espacios de nombre, clases, propiedades, funciones, que se diferencien únicamente por las mayúsculas y/o minúsculas de los nombres.
• El IDE corrige automáticamente estas cuestiones, pero otros editores no.
![Page 5: Nomenclaturas - Buenas Practicas](https://reader036.vdocumento.com/reader036/viewer/2022082408/5571fb17497959916993ebf4/html5/thumbnails/5.jpg)
Abreviaturas: Reglas Generales
• En lo posible evitar las abreviaturas: éstas únicamente deben ser usadas en casos que éstas sean muy conocidas (Ej: Html, UI, IO).
• No usar acrónimos que no sean aceptados en el campo de la informática.
• Para acrónimos utilizar capitalización Pascal cuando hay más de 2 caracteres. Ej: Html, Wsdl.
![Page 6: Nomenclaturas - Buenas Practicas](https://reader036.vdocumento.com/reader036/viewer/2022082408/5571fb17497959916993ebf4/html5/thumbnails/6.jpg)
Nomenclatura de espacios de nombres
• Se utiliza capitalización Pascal.
• Debe evitarse utilizar nombres de espacios provistos por .NET Framework.
• La constitución recomendada de un espacio de nombres es CompanyName.TechnologyName[.Feature][.Design]
![Page 7: Nomenclaturas - Buenas Practicas](https://reader036.vdocumento.com/reader036/viewer/2022082408/5571fb17497959916993ebf4/html5/thumbnails/7.jpg)
Nomenclatura de Clases
• Las clases se nombran con un sustantivo.
• Se usa capitalización Pascal.
• Utilice las abreviaturas con moderación.
• Evitar las preposiciones. En vez de escribir EstadoDeCuenta, escribir EstadoCuenta.
• No utilizar el carácter “_”Ejemplos correctos:
Public Class FileStreamPublic Class ButtonPublic Class String
![Page 8: Nomenclaturas - Buenas Practicas](https://reader036.vdocumento.com/reader036/viewer/2022082408/5571fb17497959916993ebf4/html5/thumbnails/8.jpg)
Nomenclatura de Enumeraciones
• Se utiliza capitalización Pascal para los nombres de las enumeraciones y de sus valores.
• NO UTILIZAR el sufijo Enum.
• Se utiliza un sustantivo para el nombre del tipo y de los valores de la enumeración.
![Page 9: Nomenclaturas - Buenas Practicas](https://reader036.vdocumento.com/reader036/viewer/2022082408/5571fb17497959916993ebf4/html5/thumbnails/9.jpg)
Nomenclatura de Parámetros
• Se debe utilizar un sustantivo que represente el valor que trae el parámetro.
• El nombre debe ser autodescriptivo: no debería hacer falta una descripción del parámetro para saber qué debe contener o el tipo del mismo.
• Se utiliza capitalización camel para los parámetros.
• La práctica habitual indica que se le agrega una letra p delante del nombre. Ej: pPais, pNumeroCtaCte.
![Page 10: Nomenclaturas - Buenas Practicas](https://reader036.vdocumento.com/reader036/viewer/2022082408/5571fb17497959916993ebf4/html5/thumbnails/10.jpg)
Nomenclatura de Métodos
• Se deben utilizar verbos o frases verbales como nombres.
• Se utiliza capitalización Pascal.
• El nombre debe ser autodescriptivo de la función del método.
• Utilizar abreviaturas con moderación.
• No utilizar “_” en el nombre.
![Page 11: Nomenclaturas - Buenas Practicas](https://reader036.vdocumento.com/reader036/viewer/2022082408/5571fb17497959916993ebf4/html5/thumbnails/11.jpg)
Nomenclatura de Propiedades
• Se debe utilizar un sustantivo como nombre.
• Se usa capitalización Pascal.
• Debe ser un nombre que describa lo que el parámetro contiene más que el tipo del mismo.
![Page 12: Nomenclaturas - Buenas Practicas](https://reader036.vdocumento.com/reader036/viewer/2022082408/5571fb17497959916993ebf4/html5/thumbnails/12.jpg)
A tener en cuenta…
• Recordar realizar una codificación clara y concisa, utilizando toda la potencia que proporciona el lenguaje.
• No utilizar campos públicos: deben ser siempre privados a una clase y si se deben exponer se deben mostrar a través de una propiedad.
• Utilizar los elementos del lenguaje según su propósito. Por ejemplo, no utilizar una propiedad para realizar una operatoria compleja ya que no se creó para tal fin: se debe usar un método.
• Ante la duda, dirigirse a la documentación (Guías de buenas prácticas o la propia ayuda del .NET)