Escribir comentarios

En esta lección dejarás notas en el código que el compilador ignora.

Un comentario empieza con una comilla simple y llega hasta el final de la línea. Puede ir en su propia línea o después de código.

El código de ejemplo muestra las dos formas.

VB.NET no tiene comentarios de bloque. Para comentar varias líneas se pone una comilla en cada una, y el editor lo hace con un atajo. Existe también la palabra REM, heredada del Basic de los años setenta, que hace lo mismo y ya no se usa.

Que la comilla simple sea el símbolo de comentario explica algo que se ve en otras lecciones: los caracteres sueltos se escriben "a"c y no 'a', porque las comillas simples están ocupadas.

Para documentación se usan tres comillas, ''', que generan una plantilla XML al pulsar Intro en Visual Studio. IntelliSense muestra esos textos al escribir la llamada, y con ellos se genera la documentación del proyecto.

Sobre qué escribir, la norma es explicar el porqué. En sistemas de gestión eso suele ser una regla de negocio que nadie podrá deducir del código.