Standard Edition de Visual Basic




Programa de Documentación General

Las primeras líneas del programa deben incluir " Comentarios " líneas (véase Adición de comentarios ) que identifican el nombre del proyecto, el autor del programa, fecha de creación, así como una descripción de la aplicación. Esta es la documentación estándar para cualquier lenguaje de programación, ya que ayuda a que el programador de mantenimiento para identificar al autor original, lo que le puede ahorrar horas de tiempo de investigación.

Las variables de nomenclatura

Es muy importante seguir un buen conjunto de convenciones de nombres para las variables de modo que usted será capaz de saber lo que estás mirando cuando usted está tratando desesperadamente de depurar el programa. No incluya puntuacion o espacios en los nombres de las variables, y no utilice palabras reservadas como nombres de variable de Visual Basic o Visual Basic les reporta como un problema. Use Camel Casing (a veces llamado Pascal Casing) para nombrar variables. Esto se refiere a la práctica de capitalizar la primera letra de cada palabra en un nombre de variable. He aquí algunos ejemplos:



BankBalanceDecimal

CheckNumberInteger

TotalDepositsDecimal

Tenga en cuenta que la última palabra en el nombre de la variable indica el tipo de datos. Esto no es necesario, pero es muy útil cuando se trata de encontrar un error de programación difícil de alcanzar. Por supuesto, hay flexibilidad en esto, dado que VB no se aplica la normativa. Si usted decide que su norma incluirá un guión entre cada palabra en nombre de una variable, entonces quédate con la norma. Lo 'importante entender que la consistencia en el seguimiento de las normas de programación establecidas es la clave.

Forman los componentes de nombres

Asignación de nombres a los componentes de la forma (o control), como botones, etiquetas y cuadros de texto, sino que también deben seguir una serie. Dejando los nombres predeterminados de Button1 y Label1 nunca debe ser considerada como una opción viable, ya que hará que la depuración de una tarea frustrante en el mejor. Mientras que usted puede optar por seguir los mismos estándares de nomenclatura como sus nombres de las variables que pueden ser confusos para la elección de tal cambio serían aceptables y potencialmente útil. Por ejemplo, la colocación de un carácter de subrayado entre cada palabra en un nombre de control identifica fácilmente como el control. Estos son algunos ejemplos de nombres de control:

Calculate_Button

Name_TextBox

Blue_Radiobutton

Esta pequeña diferencia se diferencia rápidamente un nombre de componente de un nombre de variable y puede ayudar a reducir la confusión durante el mantenimiento, pruebas y depuración.

Instrucciones ejecutables

Cada ejecutable línea debe ser su propia línea a menos de que sea demasiado largo para caber en una sola línea y se debe continuar. En este caso, debe estar dentro de la línea continua en una ficha para facilitar la lectura. No combinar varias sentencias ejecutables en una sola línea. Aunque Visual Basic permite que este usando dos puntos (:) como separador, no es una buena práctica de programación, ya que la segunda afirmación puede ser fácilmente pasado por alto. Recuerde, la legibilidad y comprensibilidad es el objetivo, en lugar de minimizar el número de líneas de código en su programa.

Declaración de Notas

A Observación (o " comentario ") Declaración comienza con un apóstrofe (') y es una sentencia no ejecutable. Cada procedimiento debe incluir una declaración de que una observación como la primera línea (o líneas) que explica brevemente lo que hace el procedimiento. A pesar de los cambios en las observaciones del color de Visual Basic a verde, es una buena práctica incluir una frase vacía como la primera línea y una nota en blanco en la última línea de la sección de comentarios de un procedimiento. Esto aumenta la legibilidad y reduce la tarea de separar código ejecutable a partir de observaciones.



Deja un comentario