Las primeras líneas del programa debe incluir las líneas de «Observaciones» (véase "Adición Observaciones" ) que identifican el nombre del proyecto, el autor del programa , la fecha de creación y una descripción de la aplicación . Esta es la documentación estándar para cualquier lenguaje de programación , ya que ayuda al programador de mantenimiento en la identificación del autor original , que puede ahorrar horas de tiempo de investigación .
Naming Variables
Es muy importante que siga un buen conjunto de convenciones de nombres para las variables de modo que usted será capaz de saber lo que usted está buscando en 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 de Visual Basic como nombres de variables o VB marcará como un problema . Use Camel Casing (a veces llamado Pascal Casing ) para nombrar las variables. Esto se refiere a la práctica de capitalizar la primera letra de cada palabra en un nombre de variable. Aquí hay varios ejemplos:
BankBalanceDecimal
CheckNumberInteger
TotalDepositsDecimal
Aviso de que la última palabra en el nombre de la variable denota su 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, ya que VB no hace cumplir sus normas. Si usted decide que su norma incluirá un guión entre cada palabra en nombre de una variable , entonces quédate con la norma. Es importante entender que la consistencia en el seguimiento de las normas de programación establecidas es la clave.
Nombrar componentes forman
Asignación de nombres para formar los componentes ( o controles ) tales como botones, etiquetas y cuadros de texto , también deben seguir una serie. Dejando los nombres por defecto de " Button1 " y " Label1 " no deben considerarse 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 las mismas normas de nomenclatura que los nombres de las variables que puede ser confuso para elegir una modificación de esto sería aceptable y potencialmente útil . Por ejemplo , la colocación de un carácter de subrayado entre cada palabra en un nombre de control fácilmente lo identifica como un control . Aquí hay varios ejemplos de nombres de control :
Calculate_Button
Name_TextBox
Blue_Radiobutton
Esta ligera diferencia que diferencia rápidamente un nombre de componente de un nombre de variable y puede ayudar a reducir la confusión cuando el mantenimiento , pruebas y depuración .
Instrucciones ejecutables
Cada línea ejecutable debe ser su propia línea a menos de que sea demasiado largo para caber en una sola línea y tiene que Continuará . En este caso, debe sangrar la línea continua una pestaña para facilitar su lectura . No combinar varias sentencias ejecutables en una 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 pasado por alto fácilmente. Recuerde , la legibilidad y comprensibilidad es el objetivo , en lugar de minimizar el número de líneas de código en su programa.
Observaciones declaraciones
A " Observación " (o " comentarios ") declaración comienza con un apóstrofe ( ' ) y es una sentencia no ejecutable . Cada procedimiento debe contener una declaración de la observación como la primera línea (o líneas) explicando brevemente lo que hace el procedimiento . Aunque los cambios de Visual Basic El color de las palabras a verde , es una buena práctica incluir una observación en blanco como la primera línea y una observación en blanco como la última línea de la sección de comentarios de un procedimiento. Esto aumenta la legibilidad y reduce la tarea de separar el código ejecutable a partir de observaciones .