Los comentarios de una línea y multilínea

En este capítulo, aprenderás acerca de los comentarios en el lenguaje de programación C#. Los comentarios son texto descriptivos que se utiliza para dar explicaciones en el código de lo que hacen sus diferentes partes y mejorar su legibilidad. Los comentarios no se ejecutan como parte del programa y, por lo tanto, no afectan el funcionamiento del código. Solo existen para quien lee el código, no para quién lo usa (usuario final).

Comentarios de una línea en C#

Los comentarios se pueden expresar para una sola línea o para varias a la vez. Empecemos por los de una línea.

Para expresar un comentario de una línea, utiliza la doble barra // y seguidamente, en la misma línea, escribe un breve texto.

namespace Tests
{
    class Program
    {
        static void Main(string[] args)
        {
            // Imprime un mensaje en la consola
            Console.WriteLine("Esto es Programación Fácil y estás en el curso de C#");
        }
    }
}

Si te fijas en la línea marcada, gracias a ese comentario, estoy explicando lo que hace el WriteLine.

No abuses de los comentarios, cuando llegues a crear tus propios programas finales, programas para usuarios, no hará falta que pongas en el código cosas de los fundamentos como lo que es un namespace, una clase o cosas así. Tienes que precisar más. Mira un mal ejemplo del uso de estos comentarios:

// Iniciamos el namespace Tests
namespace Tests
{
    // Creamos una clase
    class Program
    {
        // Creamos el método del programa
        static void Main(string[] args)
        {
            // Imprime un mensaje en la consola
            Console.WriteLine("Esto es Programación Fácil y estás en el curso de C#");
        }
    }
}

Ahora que aprendes, está muy bien, pero más adelante, no abuses así de los comentarios. Cuando dejes de estudiar, todo esto sobrará, ya que sabrás todas estas cosas de los fundamentos de C# y no te hará falta especificar lo que hace absolutamente cada línea.

Comentarios multilínea en C#

Los comentarios multilínea son un tipo de comentario que permite escribir varias líneas a la vez. Se utilizan para dar descripciones más largas. Por ejemplo, podríamos escribir lo que hace el programa completo.

A diferencia de los comentarios de una línea, los comentarios multilínea precisan de una apertura y un cierre que englobe las líneas. La sintaxis es /* para la apertura y */ para el cierre.

Todos los asteriscos extra, los pone Visual Studio automáticamente para mejorar la legibilidad, para hacer cada línea más visible. Sin embargo, lo único obligatorio es esa apertura y cierre.

/* 
 * Este programa está hecho por programación Fácil
 * Es un sencillo programa que imprime un mensaje
 * en la consola. 
*/
namespace Tests
{
    class Program
    {
        static void Main(string[] args)
        {
            Console.WriteLine("Esto es Programación Fácil y estás en el curso de C#");
        }
    }
}

Anular código con los comentarios

Los comentarios no solo sirven para dar explicaciones en el código. También lo anulan. Todo el texto que quede envuelto entre ellos, será tratado como comentario e ignorado por el compilador.

namespace Tests
{
    class Program
    {
        static void Main(string[] args)
        {
            //Console.WriteLine("Esto es Programación Fácil y estás en el curso de C#");
        }
    }
}

Al ejecutar esto, se abre la consola, pero no imprime el mensaje, ya que se ha anulado con el comentario.

Esto es útil si quieres hacer pruebas con parte del código, pero sin borrar nada.

Con los comentarios multilínea, anulamos todas las líneas juntas que queramos:

namespace Tests
{
    class Program
    {
        static void Main(string[] args)
        {
            /* Console.WriteLine("Mensaje 1");
            Console.WriteLine("Mensaje 2"); */
            Console.WriteLine("Mensaje 3");
        }
    }
}

Mensaje 3

Ejercicios de C#

8. Sin ejecutar este programa, ¿Sabrías decir que va a imprimir en la consola y que no?

namespace Tests
{
    class Program
    {
        static void Main(string[] args)
        {
            Console.WriteLine("Mensaje 1");
            // Console.WriteLine("Mensaje 2");
            Console.WriteLine("Mensaje 3");
        }
    }
}

La solución la encontrarás aquí: Haz click aquí.